Metodo IDispenserManager::RegisterDispenser (comsvcs.h)

Registra il distributore di risorse con il gestore del distributore.

Sintassi

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

Parametri

[in] __MIDL__IDispenserManager0000

L'interfaccia IDispenserDriver offerta dal Distributore di risorse a Gestione distributori per usarla in un secondo momento per notificare al Distributore delle risorse.

[in] szDispenserName

Nome descrittivo del Distributore di risorse per la visualizzazione dell'amministratore.

[out] __MIDL__IDispenserManager0001

Interfaccia IHolder di cui è stata creata un'istanza per il distributore di risorse.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene S_OK. In caso contrario, è E_FAIL.

Commenti

Il Distributore di risorse notifica al Manager del Distributore che è stato avviato ed è pronto ad accettare notifiche su questa interfaccia IDispenserDriver . Il gestore del distributore crea quindi il titolare per questo nuovo Distributore di risorse e lo restituisce al Distributore di risorse.

Questo metodo non chiama AddRef nell'oggetto pDispenserDriver , ma IHolder::Close esegue una release su pDispenserDriver. Ciò può causare l'eliminazione prematura dell'oggetto Resource Distributor. Per evitare questa distruzione prematura, il chiamante di IDispenserManager::RegisterDispenser deve chiamare in modo esplicito AddRef sull'oggetto pDispenserDriver .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	comsvcs.h

Vedi anche

IDispenserManager