IKnownFolder::GetIDList 方法 (shobjidl_core.h)

取得IDList (ITEMIDLIST 表單中 Shell 命名空間資料夾的位置) 。

語法

HRESULT GetIDList(
  [in]  DWORD            dwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl
);

參數

[in] dwFlags

類型: DWORD

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

[out] ppidl

類型: PIDLIST_ABSOLUTE*

當這個方法傳回時,會包含絕對 PIDL 的位址。 這個參數會以未初始化的狀態傳遞。 呼叫端應用程式負責在不再需要資源時釋出此資源。

傳回值

類型: HRESULT

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

備註

相當於 SHGetKnownFolderIDList

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll

另請參閱

IKnownFolder

已知資料夾範例

SHGetKnownFolderIDList