Share via

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) 中引進

另請參閱

已知資料夾範例