ExpandEnvironmentStringsForUserW-Funktion (userenv.h)

  • Artikel

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

Übersicht über Benutzerprofile

Referenz zu Benutzerprofilen