IPropertyPage::SetPageSite method (ocidl.h)

Article
10/13/2021

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

[in] pPageSite

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ocidl.h