SHLoadLibraryFromKnownFolder 関数 (shobjidl_core.h)

[アーティクル]
03/02/2024

指定した既知のフォルダー ID の IShellLibrary オブジェクトを作成して読み込みます。

構文

HRESULT SHLoadLibraryFromKnownFolder(
  [in]  REFKNOWNFOLDERID kfidLibrary,
  [in]  DWORD            grfMode,
  [in]  REFIID           riid,
  [out] void             **ppv
);

パラメーター

[in] kfidLibrary

型: REFKNOWNFOLDERID

IShellLibrary オブジェクトに読み込む既知のフォルダーを識別する KNOWNFOLDERID 値。

[in] grfMode

型: DWORD

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

[in] riid

型: REFIID

IShellLibrary の IID。 (詳細については、「解説」を参照してください)。

[out] ppv

型: void**

この関数が正常に返されると、読み込まれた IShellLibrary オブジェクトを受け取ります。 (詳細については、「解説」を参照してください)。

戻り値

型: HRESULT

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

注釈

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

使用法

IID_PPV_ARGS マクロは、通常、この関数の riid パラメーターと ppv パラメーターを生成するために使用されます。例については、「 SHCreateLibrary」を参照してください。

要件

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