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

包含 Winnt.h 中定义的 FILE_ATTRIBUTE_* 标志的 DWORD 值。 如果未指定，请将 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