Função ExpandEnvironmentStringsForUserA (userenv.h)

Artigo
11/20/2024

Expande a cadeia de caracteres de origem usando o bloco de ambiente estabelecido para o usuário especificado.

Sintaxe

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

Parâmetros

[in, optional] hToken

Tipo: HANDLE

Token para o usuário, retornado do LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken ou função OpenThreadToken. O token deve ter acesso TOKEN_IMPERSONATE e TOKEN_QUERY. Além disso, a partir do Windows 7, o token também deve ter acesso TOKEN_DUPLICATE. Para obter mais informações, consulte Access Rights for Access-Token Objects.

Se hToken for NULL, o bloco de ambiente conterá somente variáveis do sistema.

[in] lpSrc

Tipo: LPCTSTR

Ponteiro para a cadeia de caracteres de origem terminada em nulo a ser expandida.

[out] lpDest

Tipo: LPTSTR

Ponteiro para um buffer que recebe as cadeias de caracteres expandidas.

[in] dwSize

Tipo: DWORD

Especifica o tamanho do buffer lpDest , em TCHARs.

Valor de retorno

Tipo: BOOL

verdadeiro se bem-sucedido; caso contrário, FALSE . Para obter informações de erro estendidas, chame GetLastError.

Observações

Veja a seguir um exemplo de cadeia de caracteres de origem:

%USERPROFILE%\ntuser.dat

Quando ExpandEnvironmentStringsForUser retorna, a cadeia de caracteres de destino se expande da seguinte maneira:

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

Nota

O cabeçalho userenv.h define ExpandEnvironmentStringsForUser como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	userenv.h
biblioteca	Userenv.lib
de DLL	Userenv.dll

Consulte também

Visão geral dos perfis de usuário

Referência de perfis de usuário

Compartilhar via