Método IMFPluginControl::GetPreferredClsidByIndex (mfobjects.h)

Artigo
03/13/2024

Obtém um CLSID (identificador de classe) da lista preferencial, especificada pelo valor de índice.

Sintaxe

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD  pluginType,
  [in]  DWORD  index,
  [out] LPWSTR *selector,
  [out] CLSID  *clsid
);

Parâmetros

[in] pluginType

Membro da enumeração MF_Plugin_Type , especificando o tipo de objeto a ser enumerado.

[in] index

O índice baseado em zero do CLSID a ser recuperado.

[out] selector

Recebe o nome da chave associado ao CLSID. O chamador deve liberar a memória para a cadeia de caracteres retornada chamando a função CoTaskMemFree . Para obter mais informações sobre o formato dos nomes de chave, consulte a seção Comentários de IMFPluginControl.

[out] clsid

Recebe o CLSID no índice especificado.

Retornar valor

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.
E_INVALIDARG	Argumento inválido.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	O parâmetro de índice está fora do intervalo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mfobjects.h (include Mfidl.h)

Confira também

IMFPluginControl

Compartilhar via