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 |
|---|---|
|
Les modifications ont été appliquées avec succès et la page de propriétés est à jour avec les objets sous-jacents. |
|
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 |