Méthode IFunctionDiscovery ::CreateInstanceQuery (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 fonction spécifique instance.

Syntaxe

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

Paramètres

[in] pszFunctionInstanceIdentity

Identificateur de la fonction instance.

[in] pIFunctionDiscoveryNotification

Pointeur vers l’interface IFunctionDiscoveryNotification implémentée par l’application appelante. Si elle est spécifiée, elle active le processus de notification des modifications de découverte de fonction. Ce paramètre peut être NULL ; toutefois, elle est requise pour les fournisseurs de réseau.

[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] ppIFunctionInstanceQuery

Pointeur vers un pointeur d’interface IFunctionInstanceQuery utilisé pour retourner la requête générée.

Valeur retournée

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

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_INVALIDARG	ppIFunctionInstanceQuery a la valeur NULL.
E_OUTOFMEMORY	La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.

Remarques

Les fournisseurs de 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 IFunctionInstanceQuery retournée dans ppIFunctionInstanceQuery doit être appelée pour exécuter la requête et retourner toutes les données.

Configuration requise

Condition requise	Valeur
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