Skip to content

Latest commit

 

History

History
111 lines (94 loc) · 3.39 KB

nf-ocidl-ipropertypage-apply.md

File metadata and controls

111 lines (94 loc) · 3.39 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:ocidl.IPropertyPage.Apply
IPropertyPage::Apply (ocidl.h)
Applies the current values to the underlying objects associated with the property page as previously passed to IPropertyPage::SetObjects.
Apply
Apply method [COM]
Apply method [COM]
IPropertyPage interface
IPropertyPage interface [COM]
Apply method
IPropertyPage.Apply
IPropertyPage::Apply
_ctrl_ipropertypage_apply
com.ipropertypage_apply
ocidl/IPropertyPage::Apply
com\ipropertypage_apply.htm
com
af0a1b49-54c3-453f-bd6a-70b63d625acb
12/05/2018
Apply, Apply method [COM], Apply method [COM],IPropertyPage interface, IPropertyPage interface [COM],Apply method, IPropertyPage.Apply, IPropertyPage::Apply, _ctrl_ipropertypage_apply, com.ipropertypage_apply, ocidl/IPropertyPage::Apply
ocidl.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
OCIdl.idl
Windows
19H1
IPropertyPage::Apply
ocidl/IPropertyPage::Apply
c++
APIRef
kbSyntax
COM
OCIdl.h
IPropertyPage.Apply

IPropertyPage::Apply

-description

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

-returns

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

Return code Description
S_OK
Changes were successfully applied and the property page is current with the underlying objects.
S_FALSE
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.

-see-also

IPropertyPage