IOleControl::OnAmbientPropertyChange-Methode (ocidl.h)

  • Artikel

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

Weitere Informationen

IOleControl