IPropertyPage::Apply method (ocidl.h)
Applies the current values to the underlying objects associated with the property page as previously passed to IPropertyPage::SetObjects.
Syntax
HRESULT Apply();
Return value
This method can return the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following values.
Return code | Description |
---|---|
|
Changes were successfully applied and the property page is current with the underlying objects. |
|
Changes 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
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
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for