ExpandEnvironmentStringsForUserA-Funktion (userenv.h)
Erweitert die Quellzeichenfolge mithilfe des Umgebungsblocks, der für den angegebenen Benutzer eingerichtet wurde.
Syntax
USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
[in, optional] HANDLE hToken,
[in] LPCSTR lpSrc,
[out] LPSTR 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 |