Export (0) Print
Expand All

IPropertyPage::Apply method

Applies the current values to the underlying objects associated with the property page as previously passed to IPropertyPage::SetObjects.

Syntax


HRESULT Apply();

Parameters

This method has no parameters.

Return value

This method can return the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following values.

Return codeDescription
S_OK

Changes were successfully applied and the property page is current with the underlying objects.

S_FALSE

hanges were applied, but the property page cannot determine if its state is current with the objects.

 

Remarks

The objects to be changed are provided through a previous call to IPropertyPage::SetObjects. By calling IPropertyPage::SetObjects prior to calling this method, the caller ensures that all underlying objects have the correct interfaces through which to communicate changes. Therefore, this method should not fail because of non-existent interfaces.

After applying its values, the property page should determine if its state is now current with the objects in order to properly implement IPropertyPage::IsPageDirty and to provide both S_OK and S_FALSE return values.

Notes to Implementers

E_NOTIMPL is not a valid return value.

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft