Método IFunctionDiscovery::GetInstance (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 instância de função especificada, com base no identificador.

Sintaxe

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Parâmetros

[in] pszFunctionInstanceIdentity

O identificador da instância de função (consulte GetID).

[out] ppIFunctionInstance

Um ponteiro para um ponteiro de interface IFunctionInstance usado para retornar a interface.

Retornar valor

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

Valor/código retornado	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	O valor de pszFunctionInstanceIdentity é inválido.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	A instância de função representada pela ID especificada não existe neste computador.
E_PENDING	A chamada foi executada para um provedor que retorna resultados de forma assíncrona.

Comentários

Alguns provedores de descoberta de funções retornam seus resultados de consulta com a interface IFunctionDiscoveryNotification . GetInstance não encontra instâncias de função retornadas dessa maneira e falhará com E_PENDING. É recomendável que os clientes usem o método CreateInstanceQuery da interface IFunctionDiscovery para localizar instâncias de função para esses provedores.

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

IFunctionDiscovery