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

Pesquisa na lista preferencial um CLSID (identificador de classe) que corresponde a um nome de chave especificado.

Sintaxe

HRESULT GetPreferredClsid(
  [in]  DWORD   pluginType,
  [in]  LPCWSTR selector,
  [out] CLSID   *clsid
);

[in] pluginType

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

[in] selector

O nome da chave a ser correspondido. Para obter mais informações sobre o formato de nomes de chave, consulte a seção Comentários de IMFPluginControl.

[out] clsid

Recebe um CLSID da lista preferencial.

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_NOT_FOUND)	Nenhuma CLSID que corresponda a essa chave foi encontrada.

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 (inclua Mfidl.h)