Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[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 una raccolta di istanze di funzione specifiche.
Sintassi
HRESULT CreateInstanceCollectionQuery(
[in] const WCHAR *pszCategory,
[in] const WCHAR *pszSubCategory,
[in] BOOL fIncludeAllSubCategories,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in, out] FDQUERYCONTEXT *pfdqcQueryContext,
[out] IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);
Parametri
[in] pszCategory
Categoria per la query. Vedere Definizioni di categoria.
[in] pszSubCategory
Sottocategoria per la query. Vedere Definizioni di sottocategoria. Questo parametro può essere NULL.
Le query di sottocategoria sono supportate solo per le categorie a più livelli e alcune categorie di provider. Il provider del Registro di sistema, il provider di associazioni PnP-X e il provider di pubblicazione supportano le query di sottocategoria. I provider personalizzati possono essere progettati in modo esplicito per supportare le query di sottocategoria. Ciò significa che il parametro pszSubCategory deve essere impostato su un valore non NULL solo quando il parametro pszCategory è impostato su FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION o un valore di categoria personalizzato definito per una categoria a più livelli o un provider personalizzato che supporta le query di sottocategoria.
[in] fIncludeAllSubCategories
Se TRUE, questo metodo crea in modo ricorsivo una query per tutte le sottocategorie della categoria specificata in pszCategory, restituendo una raccolta contenente istanze di funzione da tutte le sottocategorie di pszCategory.
Se FALSE, questo metodo limita la query creata alla restituzione di istanze di funzione nella categoria specificata da pszCategory e dalla sottocategoria specificata da pszSubCategory.
[in] pIFunctionDiscoveryNotification
Puntatore all'interfaccia IFunctionDiscoveryNotification implementata dall'applicazione chiamante. Questo parametro può essere NULL. Questo puntatore è valido fino al rilascio dell'oggetto query restituito.
[in, out] pfdqcQueryContext
Puntatore al contesto in cui è stata creata la query. Il tipo FDQUERYCONTEXT è definito come DWORDLONG.
[out] ppIFunctionInstanceCollectionQuery
Puntatore al puntatore all'interfaccia IFunctionInstanceCollectionQuery .
Valore restituito
I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Il valore di pszCategory o pIID non è valido. Il valore restituito nel parametro ppIFunctionInstanceCollectionQuery è NULL. |
|
Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione. |
|
Il valore di pszCategory o pszSubCategory è sconosciuto. |
Commenti
Se si specifica pIFunctionDiscoveryNotification , abilita il processo di notifica delle modifiche di Individuazione funzioni. Questo parametro può essere NULL. Tuttavia, è necessario per i provider di rete perché non restituiscono risultati sincroni. 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 IFunctionInstanceCollectionQuery restituito in ppIFunctionInstanceCollectionQuery deve essere chiamato per eseguire la query e restituire i dati.
Requisiti
| 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 |