IPropertyPageSite::OnStatusChange method (ocidl.h)

  • Article

Informs the frame that the property page managed by this site has changed its state, that is, one or more property values have been changed in the page. Property pages should call this method whenever changes occur in their dialog boxes.

Syntax

HRESULT OnStatusChange(
  [in] DWORD dwFlags
);

Parameters

[in] dwFlags

Indicates the changes that have occurred. This parameter can contain one of the following values.

Value Meaning
PROPPAGESTATUS_DIRTY
0x1
 The values in the pages have changed, so the state of the Apply button should be updated.
PROPPAGESTATUS_VALIDATE
0x2
 Now is an appropriate time to apply changes.

Return value

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

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

See also

IPropertyPageSite