IDispenserManager::RegisterDispenser-Methode (comsvcs.h)
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 |