Metodo IFunctionDiscovery::CreateInstanceQuery (functiondiscoveryapi.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Crea una query per un'istanza di funzione specifica.

Sintassi

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

Parametri

[in] pszFunctionInstanceIdentity

Identificatore dell'istanza della funzione.

[in] pIFunctionDiscoveryNotification

Puntatore all'interfaccia IFunctionDiscoveryNotification implementata dall'applicazione chiamante. Se specificato, abilita il processo di notifica delle modifiche di Individuazione funzioni. Questo parametro può essere NULL; tuttavia è necessario per i provider di rete.

[in, out] pfdqcQueryContext

Puntatore al contesto in cui è stata creata la query. Il tipo FDQUERYCONTEXT è definito come DWORDLONG.

[out] ppIFunctionInstanceQuery

Puntatore a un puntatore all'interfaccia IFunctionInstanceQuery usato per restituire la query generata.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_INVALIDARG	ppIFunctionInstanceQuery è NULL.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.

Commenti

I provider di rete di individuazione funzioni restituiscono solo istanze tramite l'interfaccia IFunctionDiscoveryNotification .

Questo metodo inizializza solo la chiamata di query. Il metodo Execute dell'interfaccia IFunctionInstanceQuery restituito in ppIFunctionInstanceQuery deve essere chiamato per eseguire la query e restituire i dati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

Query di individuazione delle funzioni

IFunctionDiscovery