Méthode IPropertyPage ::Apply (ocidl.h)

Applique les valeurs actuelles aux objets sous-jacents associés à la page de propriétés comme précédemment passé à IPropertyPage ::SetObjects.

Syntaxe

HRESULT Apply();

Valeur de retour

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Les modifications ont été appliquées avec succès et la page de propriétés est à jour avec les objets sous-jacents.
S_FALSE	Des modifications ont été appliquées, mais la page de propriétés ne peut pas déterminer si son état est actuel avec les objets.

Remarques

Les objets à modifier sont fournis via un appel précédent à IPropertyPage ::SetObjects. En appelant IPropertyPage ::SetObjects avant d’appeler cette méthode, l’appelant s’assure que tous les objets sous-jacents disposent des interfaces appropriées pour communiquer les modifications. Par conséquent, cette méthode ne doit pas échouer en raison d’interfaces inexistantes.

Après avoir appliqué ses valeurs, la page de propriétés doit déterminer si son état est maintenant actuel avec les objets afin d’implémenter correctement IPropertyPage ::IsPageDirty et de fournir des valeurs de retour S_OK et S_FALSE .

Notes aux implémenteurs

E_NOTIMPL n’est pas une valeur de retour valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IPropertyPage