Freigeben über


SHNAMEMAPPINGW-Struktur (shellapi.h)

Enthält die alten und neuen Pfadnamen für jede Datei, die von der funktion SHFileOperation verschoben, kopiert oder umbenannt wurde.

Syntax

typedef struct _SHNAMEMAPPINGW {
  LPWSTR pszOldPath;
  LPWSTR pszNewPath;
  int    cchOldPath;
  int    cchNewPath;
} SHNAMEMAPPINGW, *LPSHNAMEMAPPINGW;

Angehörige

pszOldPath

Typ: LPTSTR-

Die Adresse eines Zeichenpuffers, der den alten Pfadnamen enthält.

pszNewPath

Typ: LPTSTR-

Die Adresse eines Zeichenpuffers, der den neuen Pfadnamen enthält.

cchOldPath

Typ: int

Die Anzahl der Zeichen in pszOldPath.

cchNewPath

Typ: int

Die Anzahl der Zeichen in pszNewPath.

Bemerkungen

Es gibt zwei Versionen dieser Struktur, eine ANSI-Version (SHFILEOPSTRUCTA) und eine Unicode-Version (SHFILEOPSTRUCTW). Die Unicode-Version ist identisch mit der ANSI-Version, mit der Ausnahme, dass breite Zeichenfolgen (LPCWSTR) anstelle von ANSI-Zeichenfolgen verwendet werden (LPCSTR). Unter Windows 98 und früher wird nur die ANSI-Version unterstützt. Unter Microsoft Windows NT 4.0 und höher werden sowohl die ANSI- als auch die Unicode-Versionen dieser Struktur unterstützt. SHNAMEMAPPINGA und SHNAMEMAPPINGW sollten niemals direkt verwendet werden; die entsprechende Struktur wird von der Vorkompilierung abhängig davon, ob die Anwendung für ANSI oder Unicode kompiliert wird, als SHNAMEMAPPING- neu definiert.

Anmerkung

Der shellapi.h-Header definiert SHNAMEMAPPING als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Header- shellapi.h

Siehe auch

SHFILEOPSTRUCT