IMFActivate::D etachObject-Methode (mfobjects.h)

  • Artikel

Trennt das erstellte Objekt vom Aktivierungsobjekt.

Syntax

HRESULT DetachObject();

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL
 Nicht implementiert.

Hinweise

Das Aktivierungsobjekt gibt alle internen Verweise auf das erstellte Objekt frei. Wenn Sie ActivateObject erneut aufrufen, erstellt das Aktivierungsobjekt eine neue instance des anderen Objekts.

Die DetachObject-Methode fährt das erstellte Objekt nicht herunter. Wenn die DetachObject-Methode erfolgreich ist, muss der Client das erstellte Objekt herunterfahren. Diese Regel gilt nur für Objekte, die über eine Shutdown-Methode verfügen oder die die IMFShutdown-Schnittstelle unterstützen. Siehe die Hinweise für IMFActivate::ActivateObject.

Die Implementierung dieser Methode ist optional. Wenn das Aktivierungsobjekt diese Methode nicht unterstützt, gibt die Methode E_NOTIMPL zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h
Bibliothek Mfuuid.lib

Weitere Informationen

Aktivierungsobjekte

IMFActivate