SHCreateShellItem 函式 (shlobj_core.h)

建立 IShellItem 物件。

注意 建議您使用 SHCreateItemWithParent 或 SHCreateItemFromIDList ，而不是此函式。

 

語法

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

參數

[in, optional] pidlParent

類型： PCIDLIST_ABSOLUTE

父系的 PIDL。 此值可以是 NULL。

[in, optional] psfParent

類型： IShellFolder*

父 IShellFolder 的指標。 此值可以是 NULL。

[in] pidl

類型： PCUITEMID_CHILD

要求之專案的 PIDL。 如果父資訊未包含在 pidlParent 或 psfParent 中，這必須是絕對 PIDL。

[out] ppsi

類型： IShellItem**

當這個方法傳回時，會包含新 IShellItem 的介面指標。

傳回值

類型： HRESULT

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

備註

SHCreateShellItem 會建立代表Shell命名空間項目的物件。 呼叫端必須在 pidlParent 或 psfParent 中提供父資訊;或者，呼叫端可以在 pidl 參數中提供絕對 IDList。

此函式有三個有效的呼叫模式：

1. 父資料夾是由絕對IDList pidlParent所識別。 pidl 參數指向可識別 pidlParent 所識別資料夾內專案的子 IDList。

   IShellItem *psi;
   SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
   
   

2. 父資料夾是由 psfParent 識別。 pidl 參數指向可識別 psfParent 所識別資料夾內專案的子IDList。

   IShellItem *psi;
   SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
   
   

3. 專案是由傳遞至 pidl 參數的絕對 IDList 所識別。

   IShellItem *psi;
   SHCreateShellItem(NULL, NULL, pidlFull, &psi);
   
   

規格需求

需求	值
最低支援的用戶端	Windows XP with SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
程式庫	Shell32.lib
Dll	Shell32.dll
API 集合	ext-ms-win-shell-shell32-l1-2-2 (於 Windows 10 10.0.14393 版)