ExpandEnvironmentStringsForUserA-Funktion (userenv.h)

Artikel
11/20/2024

Erweitert die Quellzeichenfolge mithilfe des für den angegebenen Benutzer eingerichteten Umgebungsblocks.

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, zurückgegeben von der LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessTokenoder OpenThreadToken Funktion. 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 Access Rights for Access-Token Objects.

Wenn hToken-NULL-ist, enthält der Umgebungsblock nur Systemvariablen.

[in] lpSrc

Typ: LPCTSTR-

Zeiger auf die null-beendete Quellzeichenfolge, die erweitert werden soll.

[out] lpDest

Typ: LPTSTR-

Zeigen Sie auf einen Puffer, der die erweiterten Zeichenfolgen empfängt.

[in] dwSize

Typ: DWORD-

Gibt die Größe des lpDest--Puffers in TCHARs-an.

Rückgabewert

Typ: BOOL-

TRUE bei erfolgreicher Ausführung; andernfalls FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Es folgt eine Beispielquellzeichenfolge:

%USERPROFILE%\ntuser.dat

Wenn ExpandEnvironmentStringsForUser zurückgibt, wird die Zielzeichenfolge wie folgt erweitert:

C:\Documents and Settings\UserName\ntuser.dat

Anmerkung

Der Header "userenv.h" 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	userenv.h
Library	Userenv.lib
DLL-	Userenv.dll

Siehe auch

übersicht über Benutzerprofile

Referenz zu Benutzerprofilen

Freigeben über