(comsvcs.h) IDispenserManager::RegisterDispenser 方法
向分配器管理員註冊資源分配程式。
語法
HRESULT RegisterDispenser(
[in] IDispenserDriver *__MIDL__IDispenserManager0000,
[in] LPCOLESTR szDispenserName,
[out] IHolder **__MIDL__IDispenserManager0001
);
參數
[in] __MIDL__IDispenserManager0000
資源分配器提供給分配器管理員的 IDispenserDriver 介面,以供稍後用來通知資源分配器。
[in] szDispenserName
系統管理員顯示之資源分配器的易記名稱。
[out] __MIDL__IDispenserManager0001
已針對資源分配器具現化的 IHolder 介面。
傳回值
如果方法成功,傳回值會S_OK。 否則,它會E_FAIL。
備註
資源分配器會通知分配者管理員已啟動,並準備好接受此 IDispenserDriver 介面上的通知。 然後,分配者管理員會為這個新的資源分配器建立持有者,並將它傳回給資源分配器。
此方法不會在 pDispenserDriver 物件上呼叫 AddRef,但 IHolder::Close 會在 pDispenserDriver 上執行 Release。 這可能會導致資源分配器物件提前終結。 若要避免這種提前解構,IDispenserManager::RegisterDispenser 的呼叫端必須在 pDispenserDriver 對象上明確呼叫 AddRef。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | comsvcs.h |