SHNAMEMAPPINGA-Struktur (shellapi.h)

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

Syntax

typedef struct _SHNAMEMAPPINGA {
  LPSTR pszOldPath;
  LPSTR pszNewPath;
  int   cchOldPath;
  int   cchNewPath;
} SHNAMEMAPPINGA, *LPSHNAMEMAPPINGA;

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 breite Zeichenfolgen (LPCWSTR) anstelle von ANSI-Zeichenfolgen (LPCSTR) 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-Version dieser Struktur unterstützt. SHNAMEMAPPINGA und SHNAMEMAPPINGW sollten niemals direkt verwendet werden. die entsprechende Struktur wird vom Vorkompilierer 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
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