Método IFunctionInstance::GetProviderInstanceID (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 a cadeia de caracteres do identificador para a instância do provedor. Essa cadeia de caracteres é o identificador exclusivo da instância do provedor.

Sintaxe

HRESULT GetProviderInstanceID(
  [out] WCHAR **ppszCoMemProviderInstanceIdentity
);

Parâmetros

[out] ppszCoMemProviderInstanceIdentity

A cadeia de caracteres do identificador de instância do provedor. Para dispositivos raiz, essa cadeia de caracteres tem o mesmo valor que PKEY_PNPX_GlobalIdentity.

Certifique-se de liberar esse buffer usando CoTaskMemFree.

Valor retornado

Os possíveis valores retornados 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_INVALIDARG	O valor de ppszCoMemProviderInstanceID é inválido.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.

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

Confira também

IFunctionInstance