Compartir a través de

Función ExpandEnvironmentStringsForUserA (userenv.h)

  • Artículo

Expande la cadena de origen mediante el bloque de entorno establecido para el usuario especificado.

Sintaxis

USERENVAPI BOOL ExpandEnvironmentStringsForUserA(
  [in, optional] HANDLE hToken,
  [in]           LPCSTR lpSrc,
  [out]          LPSTR  lpDest,
  [in]           DWORD  dwSize
);

Parámetros

[in, optional] hToken

Tipo: HANDLE de

Token para el usuario, devuelto del LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessTokeno función openThreadToken. El token debe tener acceso TOKEN_IMPERSONATE y TOKEN_QUERY. Además, a partir de Windows 7, el token también debe tener acceso TOKEN_DUPLICATE. Para obtener más información, vea Derechos de acceso para Access-Token Objetos.

Si hToken es null, el bloque de entorno solo contiene variables del sistema.

[in] lpSrc

Tipo: LPCTSTR de

Puntero a la cadena de origen terminada en null que se va a expandir.

[out] lpDest

Tipo: LPTSTR de

Puntero a un búfer que recibe las cadenas expandidas.

[in] dwSize

Tipo: DWORD de

Especifica el tamaño del búfer de lpDest, en TCHAR.

Valor devuelto

Tipo: BOOL de

true si se ejecuta correctamente; De lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.

Observaciones

A continuación se muestra una cadena de origen de ejemplo:

%USERPROFILE%\ntuser.dat

Cuando expandEnvironmentStringsForUser devuelve, la cadena de destino se expande de la siguiente manera:

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

Nota

El encabezado userenv.h define ExpandEnvironmentStringsForUser como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de userenv.h
biblioteca de Userenv.lib
DLL de Userenv.dll

Consulte también

Información general de perfiles de usuario de

de referencia de perfiles de usuario de