Método IFunctionInstance::GetID (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 da instância de função. Esse identificador pode ser salvo e usado posteriormente para consultar novamente a mesma instância de função por meio de IFunctionDiscovery::GetInstance.

Sintaxe

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

Parâmetros

[out] ppszCoMemIdentity

A cadeia de caracteres do identificador da instância de função. Não há limite superior no tamanho dessa cadeia de caracteres.

Essa cadeia de caracteres é uma cadeia de caracteres composta gerada pela Descoberta de Funções. Ele tem a cadeia de caracteres do identificador de instância do provedor como uma subcadeia de caracteres. Para obter mais informações sobre identificadores de provedor, consulte IFunctionInstance::GetProviderInstanceID.

Para instâncias de função retornadas por um provedor interno, esse identificador tem a garantia de identificar exclusivamente um recurso em um sistema, mesmo que o recurso seja desconectado e reconectado. Para instâncias de função retornadas por provedores personalizados, o identificador de instância de função será exclusivo se o provedor tiver um identificador de provedor exclusivo.

Esse identificador não deve ser manipulado ou fabricado programaticamente. A cadeia de caracteres só deve ser usada para recuperar instâncias de função e para fins de comparação.

Certifique-se de liberar esse buffer usando CoTaskMemFree.

Retornar valor

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 ppszCoMemID é inválido.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.

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