IOleControl::OnAmbientPropertyChange-Methode (ocidl.h)
Informiert ein Steuerelement darüber, dass sich mindestens eine der Umgebungseigenschaften des Containers geändert hat.
Syntax
HRESULT OnAmbientPropertyChange(
[in] DISPID dispID
);
Parameter
[in] dispID
Der Verteilerbezeichner der ambient-Eigenschaft, die sich geändert hat. Wenn dieser Parameter DISPID_UNKNOWN ist, gibt er an, dass sich mehrere Eigenschaften geändert haben. In diesem Fall sollte das Steuerelement alle relevanten Umgebungseigenschaften überprüfen, um ihre aktuellen Werte zu erhalten.
Rückgabewert
Diese Methode gibt in allen Fällen S_OK zurück.
Hinweise
Hinweise zu Implementierern
S_OK wird in allen Fällen zurückgegeben, auch wenn das Steuerelement keine Umgebungseigenschaften unterstützt oder ein anderer Fehler aufgetreten ist. Der Aufrufer, der die Benachrichtigung sendet, kann nicht versuchen, einen Fehlercode (z. B. E_NOTIMPL) zu verwenden, um zu bestimmen, ob die Benachrichtigung in Zukunft gesendet werden soll. Solche Semantik ist nicht Teil dieser Schnittstelle.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |