Fonction ExpandEnvironmentStringsForUserA (userenv.h)
Développe la chaîne source à l’aide du bloc d’environnement établi pour l’utilisateur spécifié.
Syntaxe
USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
[in, optional] HANDLE hToken,
[in] LPCSTR lpSrc,
[out] LPSTR lpDest,
[in] DWORD dwSize
);
Paramètres
[in, optional] hToken
Type : HANDLE
Jeton pour l’utilisateur, retourné par la fonction LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken ou OpenThreadToken . Le jeton doit disposer d’un accès TOKEN_IMPERSONATE et TOKEN_QUERY. En outre, à partir de Windows 7, le jeton doit également avoir un accès TOKEN_DUPLICATE. Pour plus d’informations, consultez Droits d’accès pour les objets Access-Token.
Si hToken a la valeur NULL, le bloc d’environnement contient uniquement des variables système.
[in] lpSrc
Type : LPCTSTR
Pointeur vers la chaîne source terminée par null à développer.
[out] lpDest
Type : LPTSTR
Pointeur vers une mémoire tampon qui reçoit les chaînes développées.
[in] dwSize
Type : DWORD
Spécifie la taille de la mémoire tampon lpDest , en TCHAR.
Valeur retournée
Type : BOOL
TRUE en cas de réussite ; sinon, FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Voici un exemple de chaîne source :
%USERPROFILE%\ntuser.dat
Lorsque ExpandEnvironmentStringsForUser retourne, la chaîne de destination se développe comme suit :
C:\Documents and Settings\UserName\ntuser.dat
Notes
L’en-tête userenv.h définit ExpandEnvironmentStringsForUser comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |