IFunctionDiscoveryProvider::Initialize, méthode (functiondiscoveryprovider.h)

Article
08/23/2023

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

Initialise l’objet fournisseur De découverte de fonction. Cette méthode est destinée à être appelée immédiatement après la création de l’objet.

Syntaxe

HRESULT Initialize(
  [in]  IFunctionDiscoveryProviderFactory *pIFunctionDiscoveryProviderFactory,
  [in]  IFunctionDiscoveryNotification    *pIFunctionDiscoveryNotification,
  [in]  LCID                              lcidUserDefault,
  [out] DWORD                             *pdwStgAccessCapabilities
);

Paramètres

[in] pIFunctionDiscoveryProviderFactory

Pointeur vers l’interface IFunctionDiscoveryProviderFactory . Le fournisseur doit utiliser cette interface pour créer de nouveaux objets de découverte de fonction.

[in] pIFunctionDiscoveryNotification

Pointeur vers une interface IFunctionDiscoveryNotification . Le fournisseur doit utiliser cette interface pour envoyer des notifications OnUpdate, OnEvent et OnError à la file d’attente de notification de découverte de fonction. Les notifications en file d’attente sont envoyées aux programmes clients par la découverte de fonction.

[in] lcidUserDefault

Identificateur des paramètres régionaux de l’appelant. Le fournisseur doit utiliser lcidUserDefault pour retourner des chaînes localisées pour la ressource énumérée par le fournisseur.

[out] pdwStgAccessCapabilities

Spécifie le mode d’accès le moins restrictif possible des magasins de propriétés associés aux instances de fonction créées par ce fournisseur.

Si la valeur DWORD est définie sur -1, InstancePropertyStoreValidateAccess est appelée chaque fois qu’OpenPropertyStore est appelé sur une fonction instance créée par ce fournisseur. Sinon, la valeur spécifiée par ce paramètre détermine le mode d’accès le moins restrictif possible pour tous les magasins de propriétés associés à toutes les instances de fonction créées par ce fournisseur. Un mode d’accès plus restrictif est appliqué à un magasin de propriétés individuel si un client appelle OpenPropertyStore avec le paramètre dwStgAccess défini sur une valeur plus restrictive que la valeur pdwStgAccessCapabilities spécifiée.

Pour plus d’efficacité, spécifiez une valeur pdwStgAccessCapabilities chaque fois que possible.

Les modes suivants sont pris en charge :

STGM_READ

STGM_READWRITE

STGM_WRITE

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	L’un des paramètres contient un argument non valide.

Notes

Si votre fournisseur va créer des objets de découverte de fonction, des notifications de file d’attente ou énumérer des ressources avec des chaînes localisées, vous devez appeler AddRef sur et mettre en cache les paramètres pIFunctionDiscoveryProviderFactory, pIFunctionDiscoveryNotification et lcidUserDefault pour une utilisation ultérieure lorsque vous implémentez la méthode Initialize .

Spécifications


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

IFunctionDiscoveryProvider

Partager via