Método IFunctionDiscovery::CreateInstanceQuery (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.]

Cria uma consulta para uma instância de função específica.

Sintaxe

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

Parâmetros

[in] pszFunctionInstanceIdentity

O identificador da instância de função.

[in] pIFunctionDiscoveryNotification

Um ponteiro para a interface IFunctionDiscoveryNotification implementada pelo aplicativo de chamada. Se especificado, ele habilita o processo de notificação de alteração da Descoberta de Funções. Esse parâmetro pode ser NULL; no entanto, é necessário para provedores de rede.

[in, out] pfdqcQueryContext

Um ponteiro para o contexto no qual a consulta foi criada. O tipo FDQUERYCONTEXT é definido como um DWORDLONG.

[out] ppIFunctionInstanceQuery

Um ponteiro para um ponteiro de interface IFunctionInstanceQuery usado para retornar a consulta gerada.

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

Comentários

Os provedores de Rede de Descoberta de Funções retornam apenas instâncias por meio da interface IFunctionDiscoveryNotification .

Esse método inicializa apenas a chamada de consulta. O método Execute da interface IFunctionInstanceQuery retornado em ppIFunctionInstanceQuery deve ser chamado para executar a consulta e retornar quaisquer dados.

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

Consultas de descoberta de função

IFunctionDiscovery