Méthode IFunctionDiscovery::CreateInstanceCollectionQuery (functiondiscoveryapi.h)

[La découverte de fonctions peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Crée une requête pour une collection d’instances de fonction spécifiques.

Syntaxe

HRESULT CreateInstanceCollectionQuery(
  [in]      const WCHAR                      *pszCategory,
  [in]      const WCHAR                      *pszSubCategory,
  [in]      BOOL                             fIncludeAllSubCategories,
  [in]      IFunctionDiscoveryNotification   *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                   *pfdqcQueryContext,
  [out]     IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);

Paramètres

[in] pszCategory

Catégorie de la requête. Consultez Définitions de catégorie.

[in] pszSubCategory

Sous-catégorie de la requête. Consultez Définitions de sous-catégorie. Ce paramètre peut être NULL.

Les requêtes de sous-catégorie sont uniquement prises en charge pour les catégories en couches et certaines catégories de fournisseurs. Le fournisseur de registre, le fournisseur d’association PnP-X et le fournisseur de publication prennent en charge les requêtes de sous-catégorie. Les fournisseurs personnalisés peuvent être conçus explicitement pour prendre en charge les requêtes de sous-catégorie. Cela signifie que le paramètre pszSubCategory doit être défini sur une valeur non NULL uniquement lorsque le paramètre pszCategory est défini sur FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION ou une valeur de catégorie personnalisée définie pour une catégorie en couches ou un fournisseur personnalisé prenant en charge les requêtes de sous-catégorie.

[in] fIncludeAllSubCategories

Si true, cette méthode crée de manière récursive une requête pour toutes les sous-catégories de la catégorie spécifiée dans pszCategory, renvoyant une collection contenant des instances de fonction de toutes les sous-catégories de pszCategory.

Si la valeur est FALSE, cette méthode limite la requête créée à retourner des instances de fonction dans la catégorie spécifiée par pszCategory et la sous-catégorie spécifiée par pszSubCategory.

[in] pIFunctionDiscoveryNotification

Pointeur vers l’interface IFunctionDiscoveryNotification implémentée par l’application appelante. Ce paramètre peut être NULL. Ce pointeur est valide jusqu’à ce que l’objet de requête retourné soit libéré.

[in, out] pfdqcQueryContext

Pointeur vers le contexte dans lequel la requête a été créée. Le type FDQUERYCONTEXT est défini en tant que DWORDLONG.

[out] ppIFunctionInstanceCollectionQuery

Pointeur vers le pointeur d’interface IFunctionInstanceCollectionQuery .

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code/valeur de retour	Description
S_OK	La commande s'est correctement terminée.
E_INVALIDARG	La valeur de pszCategory ou pIID n’est pas valide. La valeur retournée dans le paramètre ppIFunctionInstanceCollectionQuery est NULL.
E_OUTOFMEMORY	La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	La valeur de pszCategory ou pszSubCategory est inconnue.

Notes

Si pIFunctionDiscoveryNotification est spécifié, il active le processus de notification de modification de découverte de fonction. Ce paramètre peut être NULL. Toutefois, il est obligatoire pour les fournisseurs réseau, car ils ne retournent pas de résultats synchrones. Les fournisseurs réseau de découverte de fonctions retournent uniquement des instances via l’interface IFunctionDiscoveryNotification .

Cette méthode initialise uniquement l’appel de requête. La méthode Execute de l’interface IFunctionInstanceCollectionQuery retournée dans ppIFunctionInstanceCollectionQuery doit être appelée pour exécuter la requête et retourner toutes les données.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	functiondiscoveryapi.h
DLL	FunDisc.dll

Voir aussi

Requêtes de découverte de fonction

IFunctionDiscovery