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

Artigo
08/28/2023

Recupera um objeto de exclusão mútua ASF (Advanced Systems Format) do perfil.

Sintaxe

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

Parâmetros

[in] dwMutexIndex

Índice do objeto de exclusão mútua no perfil.

[out] ppIMutex

Recebe um ponteiro para a interface IMFASFMutualExclusion do objeto de exclusão mútua do ASF. O chamador deve liberar a interface.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método não cria uma cópia do objeto de exclusão mútua. O ponteiro retornado refere-se à exclusão mútua contida no objeto de perfil. Você não deve fazer nenhuma alteração no objeto de exclusão mútua usando esse ponteiro, pois isso pode afetar o objeto de perfil de maneiras inesperadas.

Para alterar a configuração do objeto de exclusão mútua no perfil, primeiro você deve clonar o objeto de exclusão mútua chamando IMFASFMutualExclusion::Clone. Faça as alterações necessárias ao clone do objeto, remova o antigo objeto de exclusão mútua do perfil chamando o método IMFASFProfile::RemoveMutualExclusion e adicione o objeto atualizado chamando o método IMFASFProfile::AddMutualExclusion .

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wmcontainer.h
Biblioteca	Mfuuid.lib