Share via


IFunctionDiscovery ::GetInstance, méthode (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.]

Obtient la fonction instance spécifiée, en fonction de l’identificateur.

Syntaxe

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Paramètres

[in] pszFunctionInstanceIdentity

Identificateur de la fonction instance (voir GetID).

[out] ppIFunctionInstance

Pointeur vers un pointeur d’interface IFunctionInstance utilisé pour retourner l’interface.

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 pszFunctionInstanceIdentity n’est pas valide.
E_OUTOFMEMORY
La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND)
0x800710d8
La fonction instance représentée par l’ID spécifié n’existe pas sur cet ordinateur.
E_PENDING
L’appel a été exécuté pour un fournisseur qui retourne des résultats de manière asynchrone.

Remarques

Certains fournisseurs de découverte de fonctions retournent leurs résultats de requête avec l’interface IFunctionDiscoveryNotification . GetInstance ne trouve pas les instances de fonction retournées de cette manière et échoue avec E_PENDING. Il est recommandé aux clients d’utiliser la méthode CreateInstanceQuery de l’interface IFunctionDiscovery pour rechercher des instances de fonction pour ces fournisseurs.

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

IFunctionDiscovery