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