IUnknown_QueryService函式 (shlwapi.h)
從指定的物件擷取服務的介面。
語法
LWSTDAPI IUnknown_QueryService(
[in] IUnknown *punk,
[in] REFGUID guidService,
[in] REFIID riid,
[out] void **ppvOut
);
參數
[in] punk
類型: IUnknown*
支援服務的 COM 物件的 IUnknown 實例指標。
[in] guidService
類型: REFGUID
服務的唯一標識碼 (SID) 。
[in] riid
類型: REFIID
所需服務介面的 IID。
[out] ppvOut
類型: void**
當這個方法傳回時,包含要求的介面指標 riid。 如果成功,當不再需要服務時,呼叫應用程式會負責呼叫 IUnknown::Release 。 如果失敗,此值為 NULL。
傳回值
類型: HRESULT
如果成功 , 則傳回S_OK。 如果物件不支援 IServiceProvider,則傳回E_FAIL。 否則,函式會傳回物件 QueryService 方法所傳回的 HRESULT。
備註
如果傳入 punk 參數的物件支援 IServiceProvider 介面,則會叫用其 QueryService 方法,傳遞 guidService、 riid 和 ppvOut 參數,並傳播傳回值。 否則,函式會傳回E_FAIL。
針對 Shlwapi.h 中不包含 IUnknown_QueryService 的 Windows 版本,必須使用序數 176 直接從 Shlwapi.dll 呼叫此函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版、Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server、Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shlwapi.h |
Dll | Shlwapi.dll (5.0 版或更新版本) |