See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This method provides IUnknownpointers for the objects associated with the property page. This method implements the IPropertyPage::SetObjectsmethod.
Syntax
HRESULT SetObjects( ULONG cObjects, LPUNKNOWN* ppUnk ); |
Parameters
- cObjects
-
Specifies the number of IUnknownpointers in the array specified by ppUnk.
- ppUnk
-
Specifies an array of IUnknownpointers.
Return Value
Returns an HRESULT value. Possible values include the following.
| Value | Description |
|---|---|
|
S_OK |
Success. |
|
E_POINTER NULL |
Pointer argument. |
|
E_UNEXPECTED |
Unexpected failure. |
Remarks
Although ppUnkspecifies an array of IUnknownpointers, the CBasePropertyPage classis designed only to support one associated object. If cObjectsis greater than 1, the method returns E_UNEXPECTED.
If cObjectsequals 1, this method calls the CBasePropertyPage::OnConnectmethod. If cObjects equals 0, this method calls the CBasePropertyPage::OnDisconnectmethod. The derived class should override both of those methods; for details, see the remarks for those methods.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have
different include file and Library requirements
For more information, see Setting Up the Build Environment,Version 2.12 requires DXPAK 1.0 or later |