共用方式為


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

類型: void**

當此函式成功傳回時,會包含 riid中要求的介面指標。 這通常是 IShellItemIShellItem2

傳回值

類型: HRESULT

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

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
Dll Shell32.dll
API 集合 ext-ms-win-shell-shell32-l1-2-0 (在 Windows 8.1) 中引進

另請參閱

已知資料夾範例