PathUnExpandEnvStringsW-Funktion (shlwapi.h)

Artikel
11/20/2024

Ersetzt bestimmte Ordnernamen in einem vollqualifizierten Pfad durch die zugehörige Umgebungszeichenfolge.

Syntax

BOOL PathUnExpandEnvStringsW(
  [in]  LPCWSTR pszPath,
  [out] LPWSTR  pszBuf,
  [in]  UINT    cchBuf
);

Parameter

[in] pszPath

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge mit maximaler Länge MAX_PATH, die den Pfad enthält, der nicht erweitert werden soll.

[out] pszBuf

Typ: LPTSTR-

Ein Zeiger auf einen Puffer, der, wenn diese Methode erfolgreich zurückgegeben wird, die nichtexpandierte Zeichenfolge empfängt. Die Größe dieses Puffers muss auf MAX_PATH festgelegt werden, um sicherzustellen, dass die zurückgegebene Zeichenfolge groß genug ist.

[in] cchBuf

Typ: UINT-

Die Größe in Zeichen im pszBuf Puffer.

Rückgabewert

Typ: BOOL-

Gibt TRUE- zurück, wenn dies erfolgreich ist; andernfalls FALSE.

Bemerkungen

Die folgenden Ordnerpfade werden durch ihre entsprechende Umgebungszeichenfolge ersetzt.

Ordner	Umgebungszeichenfolge
Der Ordner "Alle Benutzer"-Profil	%ALLUSERSPROFILE%
Der Anwendungsdatenordner des aktuellen Benutzers (nur Windows Vista und höher).	%APPDATA%
Der Systemname	%COMPUTERNAME%
Der Ordner "Programme"	%ProgramFiles%
Der Systemstammordner	%SystemRoot%
Der Laufwerkbuchstaben des Systems	%SystemDrive%
Der Profilordner des aktuellen Benutzers	%USERPROFILE%

Note %APPDATA% and %USERPROFILE% are relative to the user making the call. Diese Funktion funktioniert nicht, wenn der Benutzer von einem Dienst imitiert wird. Weitere Erläuterungen zu Problemen mit der Zugriffssteuerung finden Sie unter Zugriffssteuerung.

Die in der obigen Tabelle aufgeführten Umgebungsvariablen sind möglicherweise nicht alle auf allen Systemen festgelegt. Wenn keine Umgebungsvariable festgelegt ist, wird sie nicht erweitert.

Anmerkung

Der Header "shlwapi.h" definiert PathUnExpandEnvStrings 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 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Siehe auch

DoEnvironmentSubst

Freigeben über