IMFActivate::D etachObject-Methode (mfobjects.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |