通过

ExpandEnvironmentStringsForUserW 函数 （userenv.h）

  • 项目

使用为指定用户建立的环境块展开源字符串。

语法

USERENVAPI BOOL ExpandEnvironmentStringsForUserW(
  [in, optional] HANDLE  hToken,
  [in]           LPCWSTR lpSrc,
  [out]          LPWSTR  lpDest,
  [in]           DWORD   dwSize
);

参数

[in, optional] hToken

类型：HANDLE

用户的令牌，从 LogonUser、CreateRestrictedToken、DuplicateToken、OpenProcessToken或 OpenThreadToken 函数返回。 令牌必须具有TOKEN_IMPERSONATE和TOKEN_QUERY访问权限。 此外，从 Windows 7 起，令牌还必须具有TOKEN_DUPLICATE访问权限。 有关详细信息，请参阅 Access-Token 对象的访问权限。

如果 hTokenNULL，则环境块仅包含系统变量。

[in] lpSrc

类型：LPCTSTR

指向要展开的以 null 结尾的源字符串的指针。

[out] lpDest

类型：LPTSTR

指向接收扩展字符串的缓冲区的指针。

[in] dwSize

类型：DWORD

指定 TCHA中 lpDest 缓冲区的大小。

返回值

类型：BOOL

如果成功，则 TRUE;否则，FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

下面是一个示例源字符串：

%USERPROFILE%\ntuser.dat

ExpandEnvironmentStringsForUser 返回时，目标字符串将按如下所示展开：

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

注意

userenv.h 标头将 ExpandEnvironmentStringsForUser 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 userenv.h
库 Userenv.lib
DLL Userenv.dll

另请参阅

用户配置文件概述

用户配置文件参考