(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

另請參閱

IDispenserManager