ExpandEnvironmentStringsForUserW-Funktion (userenv.h)
Erweitert die Quellzeichenfolge mithilfe des Umgebungsblocks, der für den angegebenen Benutzer eingerichtet wurde.
Syntax
USERENVAPI BOOL ExpandEnvironmentStringsForUserW(
[in, optional] HANDLE hToken,
[in] LPCWSTR lpSrc,
[out] LPWSTR lpDest,
[in] DWORD dwSize
);
Parameter
[in, optional] hToken
Typ: HANDLE
Token für den Benutzer, das von der Funktion LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken oder OpenThreadToken zurückgegeben wird. Das Token muss über TOKEN_IMPERSONATE und TOKEN_QUERY Zugriff verfügen. Darüber hinaus muss das Token ab Windows 7 auch über TOKEN_DUPLICATE Zugriff verfügen. Weitere Informationen finden Sie unter Zugriffsrechte für Access-Token-Objekte.
Wenn hTokenNULL ist, enthält der Umgebungsblock nur Systemvariablen.
[in] lpSrc
Typ: LPCTSTR
Zeiger auf die zu erweiternde Quellzeichenfolge mit NULL-Beendigung.
[out] lpDest
Typ: LPTSTR
Zeiger auf einen Puffer, der die erweiterten Zeichenfolgen empfängt.
[in] dwSize
Art: DWORD
Gibt die Größe des lpDest-Puffers in TCHARs an.
Rückgabewert
Typ: BOOL
TRUE , wenn erfolgreich; andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Im Folgenden finden Sie ein Beispiel für eine Quellzeichenfolge:
%USERPROFILE%\ntuser.dat
Wenn ExpandEnvironmentStringsForUser zurückgibt, wird die Zielzeichenfolge wie folgt erweitert:
C:\Documents and Settings\UserName\ntuser.dat
Hinweis
Der Userenv.h-Header definiert ExpandEnvironmentStringsForUser 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 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | userenv.h |
Bibliothek | Userenv.lib |
DLL | Userenv.dll |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für