IOleControl::FreezeEvents-Methode (ocidl.h)

Gibt an, ob der Container Ereignisse vom Steuerelement ignoriert oder akzeptiert.

Syntax

HRESULT FreezeEvents(
  [in] BOOL bFreeze
);

Parameter

[in] bFreeze

Gibt an, ob der Container Ereignisse aus dem Steuerelement ignoriert (TRUE) oder jetzt (FALSE) verarbeitet.

Rückgabewert

Diese Methode gibt in allen Fällen S_OK zurück.

Hinweise

Das Steuerelement ist nicht erforderlich, um das Senden von Ereignissen zu beenden, wenn bFreezeTRUE ist. In diesem Fall verarbeitet der Container sie jedoch nicht. Wenn ein Steuerelement von der Verarbeitung des Containers abhängig ist – wie bei Anforderungsereignissen, die Informationen aus dem Container zurückgeben –, muss das Steuerelement entweder das Ereignis verwerfen oder das Ereignis in die Warteschlange stellen, um später zu senden, wenn bFreezeFALSE ist.

Hinweise zu Implementierern

Wie bei IOleControl::OnAmbientPropertyChange wird in allen Fällen S_OK zurückgegeben, um zu verhindern, dass ein Container Annahmen über das Verhalten eines Steuerelements basierend auf Rückgabewerten trifft.

Anforderungen

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