IMFASFProfile::GetMutualExclusion-Methode (wmcontainer.h)

Artikel
08/28/2023

Ruft ein ASF-Objekt (Advanced Systems Format) zum gegenseitigen Ausschluss aus dem Profil ab.

Syntax

HRESULT GetMutualExclusion(
  [in]  DWORD                 dwMutexIndex,
  [out] IMFASFMutualExclusion **ppIMutex
);

Parameter

[in] dwMutexIndex

Index des Gegenseitigkeitsausschlussobjekts im Profil.

[out] ppIMutex

Empfängt einen Zeiger auf die IMFASFMutualExclusion-Schnittstelle des ASF-Objekts für gegenseitigen Ausschluss. Der Aufrufer muss die Schnittstelle freigeben.

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.

Hinweise

Diese Methode erstellt keine Kopie des Gegenseitigkeitsausschlussobjekts. Der zurückgegebene Zeiger bezieht sich auf den gegenseitigen Ausschluss, der im Profilobjekt enthalten ist. Sie dürfen mit diesem Zeiger keine Änderungen am Objekt des gegenseitigen Ausschlusses vornehmen, da sich dies auf unerwartete Weise auf das Profilobjekt auswirken kann.

Um die Konfiguration des Gegenseitigkeitsausschlussobjekts im Profil zu ändern, müssen Sie zuerst das Objekt für gegenseitigen Ausschluss klonen, indem Sie IMFASFMutualExclusion::Clone aufrufen. Nehmen Sie alle erforderlichen Änderungen an dem Klon des Objekts vor, entfernen Sie das alte Gegenseitige Ausschlussobjekt aus dem Profil, indem Sie die IMFASFProfile::RemoveMutualExclusion-Methode aufrufen, und fügen Sie dann das aktualisierte Objekt hinzu, indem Sie die IMFASFProfile::AddMutualExclusion-Methode aufrufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcontainer.h
Bibliothek	Mfuuid.lib