PERSIST_FOLDER_TARGET_INFO 結構 (shobjidl_core.h)

  • 發行項

指定資料夾快捷方式的目標資料夾及其屬性。 IPersistFolder3：：GetFolderTargetInfo 和 IPersistFolder3：：InitializeEx 會使用此結構。

語法

typedef struct _PERSIST_FOLDER_TARGET_INFO {
  PIDLIST_ABSOLUTE pidlTargetFolder;
  WCHAR            szTargetParsingName[260];
  WCHAR            szNetworkProvider[260];
  DWORD            dwAttributes;
  int              csidl;
} PERSIST_FOLDER_TARGET_INFO;

成員

pidlTargetFolder

類型： PIDLIST_ABSOLUTE

目標資料夾的完整 PIDL。 如果未指定 ，請將 pidlTargetFolder 設定為 NULL 。

szTargetParsingName[260]

類型： WCHAR[MAX_PATH]

以 Null 結尾的 Unicode 字串，具有目標資料夾的剖析名稱。 如果未指定 ，請將 szTargetParsingName 設定為空字串。

szNetworkProvider[260]

類型： WCHAR[MAX_PATH]

Null 終止的 Unicode 字串，指定系結至目標資料夾時將使用的網路提供者類型。 格式與 WNet API 所使用的格式相同。 如果未指定 ，請將 szNetworkProvider 設定為空字串。

dwAttributes

類型： DWORD

DWORD 值，其中包含 Winnt.h 中所定義的FILE_ATTRIBUTE_* 旗標。 如果未指定 ，請將 dwAttributes 設定為 -1。

csidl

類型： int

如果目標資料夾有一個，則為目標資料夾的 CSIDL 值。 如果目標資料夾沒有 CSIDL，請將 csidl 設定為 -1。 除了 CSIDL 值之外，您也可以設定下列兩個旗標。

CSIDL_FLAG_PFTI_TRACKTARGET

表示如果使用者變更目標資料夾的基礎 CSIDL 值，則目標資料夾應該變更。

CSIDL_FLAG_CREATE

指出如果目標資料夾不存在，則應該加以建立。

備註

任何或所有 pidlTargetFolder、 szTargetParsingName 和 csidl 成員都可以用來指定目標資料夾的位置。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 shobjidl_core.h (包括 Shobjidl.h)

另請參閱

IPersistFolder3