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

Artículo
08/28/2023

Recupera un objeto de exclusión mutua del formato de sistemas avanzados (ASF) del perfil.

Sintaxis

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

Parámetros

[in] dwMutexIndex

Índice del objeto de exclusión mutua en el perfil.

[out] ppIMutex

Recibe un puntero a la interfaz IMFASFMutualExclusion del objeto de exclusión mutua de ASF. El autor de la llamada debe liberar la interfaz .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Observaciones

Este método no crea una copia del objeto de exclusión mutua. El puntero devuelto hace referencia a la exclusión mutua contenida en el objeto de perfil. No debe realizar ningún cambio en el objeto de exclusión mutua mediante este puntero, ya que hacerlo puede afectar al objeto de perfil de maneras inesperadas.

Para cambiar la configuración del objeto de exclusión mutua en el perfil, primero debe clonar el objeto de exclusión mutua llamando a IMFASFMutualExclusion::Clone. Realice los cambios necesarios para el clon del objeto, quite el antiguo objeto de exclusión mutua del perfil llamando al método IMFASFProfile::RemoveMutualExclusion y agregue el objeto actualizado llamando al método IMFASFProfile::AddMutualExclusion .

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wmcontainer.h
Library	Mfuuid.lib