IPropertyPage::SetPageSite method

Initializes a property page and provides the page with a pointer to the IPropertyPageSite interface through which the property page communicates with the property frame.

Syntax


HRESULT SetPageSite(
  [in] IPropertyPageSite *pPageSite
);

Parameters

pPageSite [in]

A pointer to the IPropertyPageSite interface of the page site that manages and provides services to this property page within the entire property sheet.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and S_OK.

Remarks

Notes to Implementers

If the pPageSite parameter is NULL, this method must call Release on any IPropertyPageSite pointer passed during a previous call to this method. If non-NULL, this method must save the IPropertyPageSite pointer value and call AddRef. Two consecutive calls to this method with a non-NULL site pointer are not allowed and should cause the property page to return E_UNEXPECTED.

E_NOTIMPL is not a valid return value. All property pages must implement this method.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IPropertyPage is defined as B196B28D-BAB4-101A-B69C-00AA00341D07

See also

IPropertyPage

 

 

Show: