共用方式為

SHOpenFolderAndSelectItems 函式 (shlobj_core.h)

  • 發行項

開啟 Windows 檔案總管視窗，其中已選取特定資料夾中的指定專案。

語法

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

參數

[in] pidlFolder

類型： PCIDLIST_ABSOLUTE

指定資料夾之完整項目識別碼清單的指標。

cidl

類型： UINT

選取陣列中的項目計數 apidl。 如果 cidl 為零， pidlFolder 必須指向描述要選取之單一專案的完全指定 ITEMIDLIST 。 此函式會開啟父資料夾，並選取該專案。

[in, optional] apidl

類型： PCUITEMID_CHILD_ARRAY

PIDL 結構的陣列指標，其中每一個都是要選取 pidlFolder 所參考之目標資料夾中的專案。

dwFlags

類型： DWORD

選擇性旗標。 在 Windows XP 下，會忽略此參數。 在 Windows Vista 中，會定義下列旗標。

OFASI_EDIT (0x0001)

選取專案，並將其名稱放在編輯模式中。 只有在選取單一專案時，才能使用此旗標。 對於多個項目選取專案，則會忽略它。

OFASI_OPENDESKTOP (0x0002)

選取桌面上的專案或專案，而不是在 Windows 檔案總管視窗中。 請注意，如果桌面在開啟的視窗后隱藏，將不會顯示。

傳回值

類型： HRESULT

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

備註

必須先呼叫 CoInitialize 或 CoInitializeEx，才能使用 SHOpenFolderAndSelectItems。 未這麼做會導致 SHOpenFolderAndSelectItems 失敗。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.0 版或更新版本)