IDispenserManager::RegisterDispenser 方法 (comsvcs.h)
向分配器管理器注册资源分配器。
语法
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 |