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中要求的介面指標。 這通常是 IShellItem 或 IShellItem2。
傳回值
類型： 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) 中引進 |