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

Registra o distribuidor de recursos com o gerenciador de distribuidores.

Sintaxe

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

Parâmetros

[in] __MIDL__IDispenserManager0000

A interface IDispenserDriver que o Distribuidor de Recursos oferece ao Gerenciador de Distribuidores para usar posteriormente para notificar o Distribuidor de Recursos.

[in] szDispenserName

Um nome amigável da exibição do Distribuidor de Recursos para administrador.

[out] __MIDL__IDispenserManager0001

A interface IHolder que foi instanciada para o distribuidor de recursos.

Retornar valor

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.

Comentários

O Distribuidor de Recursos notifica o Gerenciador de Distribuidores de que ele foi iniciado e está preparado para aceitar notificações nessa interface IDispenserDriver . Em seguida, o Gerenciador de Distribuidores cria o Titular para esse novo Dispensador de Recursos e o retorna para o Distribuidor de Recursos.

Esse método não chama AddRef no objeto pDispenserDriver , mas IHolder::Close executa um Release no pDispenserDriver. Isso pode fazer com que o objeto Resource Dispenser seja destruído prematuramente. Para evitar essa destruição prematura, o chamador de IDispenserManager::RegisterDispenser deve chamar explicitamente AddRef no objeto pDispenserDriver .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	comsvcs.h

Confira também

IDispenserManager