CBasePropertyPage::SetObjects
A version of this page is also available for
4/8/2010
This method provides IUnknown pointers for the objects associated with the property page. This method implements the IPropertyPage::SetObjects method.
Syntax
HRESULT SetObjects(
ULONG cObjects,
LPUNKNOWN* ppUnk
);
Parameters
- cObjects
Specifies the number of IUnknown pointers in the array specified by ppUnk.
- ppUnk
Specifies an array of IUnknown pointers.
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 ppUnk specifies an array of IUnknown pointers, the CBasePropertyPage class is designed only to support one associated object. If cObjects is greater than 1, the method returns E_UNEXPECTED.
If cObjects equals 1, this method calls the CBasePropertyPage::OnConnect method. If cObjects equals 0, this method calls the CBasePropertyPage::OnDisconnect method. 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 |