SHCreateItemInKnownFolder 関数 (shobjidl_core.h)

既知のフォルダー内に存在する 1 つのファイルのシェル項目オブジェクトを作成します。

構文

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

パラメーター

[in] kfid

型: REFKNOWNFOLDERID

アイテムを含むフォルダーを識別する GUID である KNOWNFOLDERID への参照。

dwKFFlags

型: DWORD

オブジェクトの取得に特別なオプションを指定するフラグ。 この値には 0 を指定できます。それ以外の場合は、1 つ以上の KNOWN_FOLDER_FLAG 値。

[in, optional] pszItem

型: PCWSTR

新しい項目のファイル名を Unicode 文字列として含む null で終わるバッファーへのポインター。 このパラメーターは NULL にすることもできます。 この場合、既知のフォルダー自体を表す IShellItem が作成されます。

[in] riid

型: REFIID

ppv を介して取得された項目を表すインターフェイスの IID への参照。 通常、この値はIID_IShellItemまたはIID_IShellItem2です。

[out] ppv

型: void**

この関数が正常に返されると、 riid で要求されたインターフェイス ポインターが含まれます。 これは通常、 IShellItem または IShellItem2 です。

戻り値

型: HRESULT

この関数が成功すると、S_OKが返 されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

Requirements

こちらも参照ください

既知のフォルダーのサンプル