PERSIST_FOLDER_TARGET_INFO Struktur (shobjidl_core.h)

  • Artikel

Gibt den Zielordner einer Ordnerverknüpfung und die zugehörigen Attribute an. Diese Struktur wird von IPersistFolder3::GetFolderTargetInfo und IPersistFolder3::InitializeEx verwendet.

Syntax

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

Member

pidlTargetFolder

Typ: PIDLIST_ABSOLUTE

Eine vollqualifizierte PIDL des Zielordners. Legen Sie pidlTargetFolder auf NULL fest, falls nicht angegeben.

szTargetParsingName[260]

Typ: WCHAR[MAX_PATH]

Eine Unicode-Zeichenfolge mit Null-Beendigung mit dem Analysenamen des Zielordners. Legen Sie szTargetParsingName auf eine leere Zeichenfolge fest, falls nicht angegeben.

szNetworkProvider[260]

Typ: WCHAR[MAX_PATH]

Eine Unicode-Zeichenfolge mit Null-Beendigung, die den Typ des Netzwerkanbieters angibt, der bei der Bindung an den Zielordner verwendet wird. Das Format entspricht dem format, das von der WNet-API verwendet wird. Legen Sie szNetworkProvider auf eine leere Zeichenfolge fest, falls nicht angegeben.

dwAttributes

Art: DWORD

Ein DWORD-Wert , der FILE_ATTRIBUTE_*-Flags enthält, wie in Winnt.h definiert. Legen Sie dwAttributes auf -1 fest, falls nicht angegeben.

csidl

Typ: int

Der CSIDL-Wert des Zielordners, sofern er über einen verfügt. Legen Sie csidl auf -1 fest, wenn der Zielordner keine CSIDL aufweist. Zusätzlich zum CSIDL-Wert können Sie auch die folgenden beiden Flags festlegen.

CSIDL_FLAG_PFTI_TRACKTARGET

Gibt an, dass sich der Zielordner ändern soll, wenn der Benutzer den dem Zielordner zugrunde liegenden CSIDL-Wert ändert.

CSIDL_FLAG_CREATE

Gibt an, dass der Zielordner erstellt werden soll, wenn er noch nicht vorhanden ist.

Hinweise

Die Elemente pidlTargetFolder, szTargetParsingName und csidl können verwendet werden, um den Speicherort des Zielordners anzugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IPersistFolder3