IDispenserManager::RegisterDispenser-Methode (comsvcs.h)

  • Artikel

Registriert den Ressourcenspender beim Dispenser-Manager.

Syntax

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

Parameter

[in] __MIDL__IDispenserManager0000

Die IDispenserDriver-Schnittstelle , die der Resource Dispenser für den Dispenser-Manager anbietet, um den Resource Dispenser später zu benachrichtigen.

[in] szDispenserName

Ein Anzeigename des Resource Dispenser für die Administratoranzeige.

[out] __MIDL__IDispenserManager0001

Die IHolder-Schnittstelle , die für den Ressourcenspender instanziiert wurde.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist es E_FAIL.

Hinweise

Der Ressourcenspender benachrichtigt den Dispenser-Manager, dass er gestartet wurde und bereit ist, Benachrichtigungen auf dieser IDispenserDriver-Schnittstelle zu akzeptieren. Anschließend erstellt der Dispenser-Manager den Holder für diesen neuen Resource Dispenser und gibt ihn an den Resource Dispenser zurück.

Diese Methode ruft AddRef nicht für das pDispenserDriver-Objekt auf, aber IHolder::Close führt ein Release für pDispenserDriver aus. Dies kann dazu führen, dass das Resource Dispenser-Objekt vorzeitig zerstört wird. Um diese vorzeitige Zerstörung zu verhindern, muss der Aufrufer von IDispenserManager::RegisterDispenserExplizit AddRef für das pDispenserDriver-Objekt aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comsvcs.h

Weitere Informationen

IDispenserManager