ExpandEnvironmentStringsForUserA-Funktion (userenv.h)

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

Anforderungen

Siehe auch

übersicht über Benutzerprofile

Referenz zu Benutzerprofilen