IFunctionDiscoveryProviderFactory ::CreateInstance, méthode (functiondiscoveryprovider.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.]

Crée une instance de fonction. Toutes les instances de fonction doivent être créées à l’aide de cette méthode. Les autres implémentations qui prennent en charge IFunctionInstance ne doivent pas être utilisées.

Syntaxe

HRESULT CreateInstance(
  [in]  const WCHAR                *pszSubCategory,
  [in]  const WCHAR                *pszProviderInstanceIdentity,
  [in]  INT_PTR                    iProviderInstanceContext,
  [in]  IPropertyStore             *pIPropertyStore,
  [in]  IFunctionDiscoveryProvider *pIFunctionDiscoveryProvider,
  [out] IFunctionInstance          **ppIFunctionInstance
);

Paramètres

[in] pszSubCategory

Chaîne de sous-catégorie pour la fonction instance. Consultez Définitions de sous-catégorie.

[in] pszProviderInstanceIdentity

Identificateur de instance fournisseur.

Function Discovery utilise cet identificateur pour s’assurer que les identificateurs de fonction instance retournés par IFunctionInstance ::GetID sont uniques. À cette fin, la découverte de fonction attache un préfixe à l’identificateur passé à pszProviderInstanceIdentity pour s’assurer qu’une fonction donnée instance identificateur est unique parmi tous les fournisseurs. Les implémenteurs doivent uniquement s’assurer que pszProviderInstanceIdentity identifie de manière unique l’appareil, la ressource ou instance dans l’étendue du fournisseur.

Cette chaîne est retournée aux applications clientes qui appellent IFunctionInstance ::GetProviderInstanceID.

Il n’existe aucune limite supérieure à la taille de cette chaîne.

[in] iProviderInstanceContext

Contexte associé à la fonction spécifique instance.

[in] pIPropertyStore

Pointeur vers une interface IPropertyStore .

[in] pIFunctionDiscoveryProvider

Pointeur vers le fournisseur IFunctionDiscoveryProvider instance la création de cette instance de fonction.

[out] ppIFunctionInstance

Pointeur vers une interface IFunctionInstance .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le fournisseur doit spécifier la sous-catégorie (peut être NULL), l’identificateur instance, un contexte alloué par le fournisseur (si nécessaire) et un magasin de propriétés facultatif.

CreateInstance retourne une fonction correctement initialisée instance au fournisseur.

Le contexte spécifié par le fournisseur sera renvoyé au fournisseur pour toutes les fonctions suivantes instance méthodes associées, telles que InstanceReleased, InstancePropertyStoreOpen, InstancePropertyStoreFlush et InstanceQueryService.

Le fournisseur doit garantir que le nombre de références du fournisseur n’atteint pas zéro, éventuellement sur un autre thread, pendant l’appel de CreateInstance .

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 functiondiscoveryprovider.h

Voir aussi

IFunctionDiscoveryProviderFactory