SHNAMEMAPPINGW-Struktur (shellapi.h)

  • Artikel

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

Syntax

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

Member

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.

Hinweise

Es gibt zwei Versionen dieser Struktur, eine ANSI-Version (SHFILEOPSTRUCTA) und eine Unicode-Version (SHFILEOPSTRUCTW). Die Unicode-Version ist mit der ANSI-Version identisch, mit der Ausnahme, dass anstelle von ANSI-Zeichenfolgen (LPCSTR) Breitzeichenzeichenfolgen (LPCWSTR) verwendet werden. 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 vom Vorcompiler als SHNAMEMAPPING neu definiert, je nachdem, ob die Anwendung für ANSI oder Unicode kompiliert wird.

Hinweis

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
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile shellapi.h

Weitere Informationen

SHFILEOPSTRUCT