Méthode IDispenserManager ::RegisterDispenser (comsvcs.h)

  • Article

Inscrit le distributeur de ressources auprès du gestionnaire du distributeur.

Syntaxe

HRESULT RegisterDispenser(
  [in]  IDispenserDriver *__MIDL__IDispenserManager0000,
  [in]  LPCOLESTR        szDispenserName,
  [out] IHolder          **__MIDL__IDispenserManager0001
);

Paramètres

[in] __MIDL__IDispenserManager0000

L’interface IDispenserDriver que le distributeur de ressources offre au gestionnaire de distribution pour l’utiliser ultérieurement pour notifier le distributeur de ressources.

[in] szDispenserName

Nom convivial de l’affichage du distributeur de ressources pour l’administrateur.

[out] __MIDL__IDispenserManager0001

Interface IHolder instanciée pour le distributeur de ressources.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, c’est E_FAIL.

Remarques

Le distributeur de ressources avertit le Gestionnaire du distributeur qu’il a démarré et est prêt à accepter les notifications sur cette interface IDispenserDriver . Ensuite, le gestionnaire de distribution crée le titulaire pour ce nouveau distributeur de ressources et le retourne au distributeur de ressources.

Cette méthode n’appelle pas AddRef sur l’objet pDispenserDriver , mais IHolder ::Close effectue une opération Release sur pDispenserDriver. Cela peut entraîner la destruction prématurée de l’objet Générateur de ressources. Pour éviter cette destruction prématurée, l’appelant d’IDispenserManager ::RegisterDispenser doit appeler explicitement AddRef sur l’objet pDispenserDriver .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête comsvcs.h

Voir aussi

IDispenserManager