SHCreateItemInKnownFolder 函式 （shobjidl_core.h）

為存在於已知資料夾內的單一檔案建立 Shell 專案物件。

語法

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

參數

[in] kfid

類型： REFKNOWNFOLDERID

KNOWNFOLDERID 的參考，這是識別包含專案之資料夾的 GUID。

dwKFFlags

類型： DWORD

在物件擷取中指定特殊選項的旗標。 此值可以是 0;否則，一或多個 KNOWN_FOLDER_FLAG 值。

[in, optional] pszItem

類型： PCWSTR

以 Null 結尾的緩衝區的指標，其中包含新專案的檔名作為 Unicode 字串。 此參數也可以是 NULL。 在此情況下，會建立代表已知資料夾本身的 IShellItem 。

[in] riid

類型： REFIID

代表專案之介面 IID 的參考，透過 ppv 擷取。 此值通常為IID_IShellItem或IID_IShellItem2。

[out] ppv

類型： 無效**

當此函式成功傳回時，包含 riid 中要求的介面指標。 這通常是 IShellItem 或 IShellItem2。

返回值

類型：HRESULT

如果函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

另請參閱

已知資料夾範例