Partager via


IOleControl ::OnAmbientPropertyChange, méthode (ocidl.h)

Informe un contrôle qu’une ou plusieurs des propriétés ambiantes du conteneur ont changé.

Syntaxe

HRESULT OnAmbientPropertyChange(
  [in] DISPID dispID
);

Paramètres

[in] dispID

Identificateur de répartition de la propriété ambiante qui a été modifiée. Si ce paramètre est DISPID_UNKNOWN, cela indique que plusieurs propriétés ont été modifiées. Dans ce cas, le contrôle doit case activée toutes les propriétés ambiantes intéressantes pour obtenir leurs valeurs actuelles.

Valeur retournée

Cette méthode retourne S_OK dans tous les cas.

Remarques

Notes aux implémenteurs

S_OK est retourné dans tous les cas, même lorsque le contrôle ne prend pas en charge les propriétés ambiantes ou qu’une autre défaillance s’est produite. L’appelant qui envoie la notification ne peut pas tenter d’utiliser un code d’erreur (tel que E_NOTIMPL) pour déterminer s’il faut envoyer la notification à l’avenir. Cette sémantique ne fait pas partie de cette interface.

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

IOleControl