PathUnExpandEnvStringsA-Funktion (shlwapi.h)

Artikel
08/26/2023

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

Syntax

BOOL PathUnExpandEnvStringsA(
  [in]  LPCSTR pszPath,
  [out] LPSTR  pszBuf,
  [in]  UINT   cchBuf
);

Parameter

[in] pszPath

Typ: LPCTSTR

Ein Zeiger auf eine null-endende 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 die nicht erweiterten Zeichenfolge empfängt, wenn diese Methode erfolgreich zurückgegeben wird. Die Größe dieses Puffers muss auf MAX_PATH festgelegt werden, um sicherzustellen, dass er groß genug ist, um die zurückgegebene Zeichenfolge zu enthalten.

[in] cchBuf

Typ: UINT

Die Größe in Zeichen im pszBuf-Puffer .

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn dies erfolgreich war. andernfalls FALSE.

Hinweise

Die folgenden Ordnerpfade werden durch die entsprechende Umgebungszeichenfolge ersetzt.

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

Beachten Sie , dass %APPDATA% und %USERPROFILE% relativ zum Benutzer sind, der den Anruf vornimmt. Diese Funktion funktioniert nicht, wenn der Benutzer von einem Dienst aus identitätswechselt wird. Weitere Informationen zu Problemen mit der Zugriffssteuerung finden Sie unter Access Control.

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

Hinweis

Der shlwapi.h-Header 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


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

DoEnvironmentSubst

Share via