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

  • Artículo

Registra el dispensador de recursos con el administrador del dispensador.

Sintaxis

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

Parámetros

[in] __MIDL__IDispenserManager0000

La interfaz IDispenserDriver que el dispensador de recursos ofrece al Administrador de dispensadores para usarlo más adelante para notificar al dispensador de recursos.

[in] szDispenserName

Nombre descriptivo del dispensador de recursos para mostrar el administrador.

[out] __MIDL__IDispenserManager0001

Interfaz IHolder a la que se ha creado una instancia del dispensador de recursos.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, es E_FAIL.

Comentarios

El dispensador de recursos notifica al Dispensador que se ha iniciado y está preparado para aceptar notificaciones en esta interfaz IDispenserDriver . A continuación, el administrador del dispensador crea el titular para este nuevo dispensador de recursos y lo devuelve al dispensador de recursos.

Este método no llama a AddRef en el objeto pDispenserDriver , pero IHolder::Close realiza una versión en pDispenserDriver. Esto puede hacer que el objeto Resource Dispenser se destruya prematuramente. Para evitar esta destrucción prematura, el autor de la llamada de IDispenserManager::RegisterDispenser debe llamar explícitamente a AddRef en el objeto pDispenserDriver .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comsvcs.h

Consulte también

IDispenserManager