Compartilhar via


Método IFunctionInstance::GetCategory (functiondiscoveryapi.h)

[A Descoberta de Funções está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Obtém as cadeias de caracteres de categoria e subcategoria para a instância de função.

Sintaxe

HRESULT GetCategory(
  [out] WCHAR **ppszCoMemCategory,
  [out] WCHAR **ppszCoMemSubCategory
);

Parâmetros

[out] ppszCoMemCategory

A cadeia de caracteres do identificador terminada em nulo da categoria. Consulte Definições de categoria.

Certifique-se de liberar esse buffer usando CoTaskMemFree.

[out] ppszCoMemSubCategory

A cadeia de caracteres do identificador terminada em nulo da subcategoria. Consulte Definições de subcategoria.

Retornar valor

Os valores retornados possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno Descrição
S_OK
O método foi concluído com sucesso.
E_OUTOFMEMORY
O método não pode alocar a memória necessária para executar essa operação.

Comentários

A categoria e a subcategoria de uma instância de função sempre se referem à categoria de provedor da qual uma instância de função vem.

Requisitos

Requisito Valor
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 functiondiscoveryapi.h
DLL FunDisc.dll

Confira também

IFunctionInstance