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 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server、Windows Server 2003 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
[DLL]	Shlwapi.dll (バージョン 5.0 以降)

こちらもご覧ください

IServiceProvider

QueryService