This topic has not yet been rated - Rate this topic

PERSIST_FOLDER_TARGET_INFO structure

Specifies a folder shortcut's target folder and its attributes. This structure is used by IPersistFolder3::GetFolderTargetInfo and IPersistFolder3::InitializeEx.

Syntax

C++


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

Members

pidlTargetFolder

Type: PIDLIST_ABSOLUTE

A fully qualified PIDL of the target folder. Set pidlTargetFolder to NULL if not specified.

szTargetParsingName

Type: WCHAR[MAX_PATH]

A null-terminated Unicode string with the target folder's parsing name. Set szTargetParsingName to an empty string if not specified.

szNetworkProvider

Type: WCHAR[MAX_PATH]

A null-terminated Unicode string that specifies the type of network provider that will be used when binding to the target folder. The format is the same as that used by the WNet API. Set szNetworkProvider to an empty string if not specified.

dwAttributes

Type: DWORD

A DWORD value that contains FILE_ATTRIBUTE_* flags as defined in Winnt.h. Set dwAttributes to -1 if not specified.

csidl

Type: int

The target folder's CSIDL value, if it has one. Set csidl to -1 if the target folder does not have a CSIDL. In addition to the CSIDL value, you can also set the following two flags.

CSIDL_FLAG_PFTI_TRACKTARGET: Indicates that the target folder should change if the user changes the target folder's underlying CSIDL value.
CSIDL_FLAG_CREATE: Indicates that the target folder should be created if it does not already exist.

Remarks

Any or all of the pidlTargetFolder, szTargetParsingName, and csidl members can be used to specify the target folder's location.

Requirements

Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Shobjidl.h
IDL	Shobjidl.idl

Community Additions