SHLoadLibraryFromParsingName 関数 (shobjidl_core.h)

  • [アーティクル]

指定したパスの IShellLibrary オブジェクトを作成して読み込みます。

構文

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

パラメーター

[in] pszParsingName

種類: PCWSTR

IShellLibrary オブジェクトを読み込むパス。

[in] grfMode

型: DWORD

ライブラリ オブジェクトのアクセスモードと共有モードを指定する 1 つ以上のストレージ メディア フラグ。 一般的に指定されるフラグは 、STGM_READ または STGM_READWRITEです。 詳細については、「 STGM」を参照してください。

[in] riid

種類: REFIID

ppv を介して取得するインターフェイスの IID への参照 (通常はIID_IShellLibrary。

[out] ppv

型: void**

このメソッドが正常に返されると、 には riid で要求されたインターフェイス ポインターが含まれます。 これは通常 、IShellLibrary です。

戻り値

種類: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

解説

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されている IID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、 riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。

これは、 IShellLibrary::LoadLibraryFromItem メソッドをラップするインライン ヘルパー関数です。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)

関連項目

IShellLibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder