Share via

IFunctionInstance ::GetID, méthode (functiondiscoveryapi.h)

  • Article

[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 chaîne d’identificateur de la fonction instance. Cet identificateur peut être enregistré et utilisé ultérieurement pour interroger à nouveau la même fonction instance via IFunctionDiscovery ::GetInstance.

Syntaxe

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

Paramètres

[out] ppszCoMemIdentity

La fonction instance chaîne d’identificateur. Il n’existe aucune limite supérieure à la taille de cette chaîne.

Cette chaîne est une chaîne composée générée par la découverte de fonction. Il a la chaîne d’identificateur instance fournisseur en tant que sous-chaîne. Pour plus d’informations sur les identificateurs de fournisseur, consultez IFunctionInstance ::GetProviderInstanceID.

Pour les instances de fonction retournées par un fournisseur intégré, cet identificateur est garanti pour identifier de manière unique une ressource sur un système, même si la ressource est déconnectée et reconnectée. Pour les instances de fonction retournées par des fournisseurs personnalisés, la fonction instance identificateur est unique si le fournisseur a un identificateur de fournisseur unique.

Cet identificateur ne doit pas être manipulé ou fabriqué par programmation. La chaîne doit uniquement être utilisée pour récupérer des instances de fonction et à des fins de comparaison.

Veillez à libérer cette mémoire tampon à l’aide de CoTaskMemFree.

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
 La valeur de ppszCoMemID n’est pas valide.
E_OUTOFMEMORY
 La méthode ne peut pas allouer la mémoire nécessaire pour effectuer cette opération.

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

IFunctionInstance