Méthode IMFASFProfile::GetMutualExclusion (wmcontainer.h)

Article
08/28/2023

Récupère un objet d’exclusion mutuelle ASF (Advanced Systems Format) du profil.

Syntaxe

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

Paramètres

[in] dwMutexIndex

Index de l’objet d’exclusion mutuelle dans le profil.

[out] ppIMutex

Reçoit un pointeur vers l’interface IMFASFMutualExclusion de l’objet d’exclusion mutuelle ASF. L’appelant doit libérer l’interface.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Cette méthode ne crée pas de copie de l’objet d’exclusion mutuelle. Le pointeur retourné fait référence à l’exclusion mutuelle contenue dans l’objet de profil. Vous ne devez pas apporter de modifications à l’objet d’exclusion mutuelle à l’aide de ce pointeur, car cela peut affecter l’objet de profil de manière inattendue.

Pour modifier la configuration de l’objet d’exclusion mutuelle dans le profil, vous devez d’abord cloner l’objet d’exclusion mutuelle en appelant IMFASFMutualExclusion::Clone. Apportez les modifications requises au clone de l’objet, supprimez l’ancien objet d’exclusion mutuelle du profil en appelant la méthode IMFASFProfile::RemoveMutualExclusion , puis ajoutez l’objet mis à jour en appelant la méthode IMFASFProfile::AddMutualExclusion .

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wmcontainer.h
Bibliothèque	Mfuuid.lib