Função GetEnvironmentStrings (processenv.h)

Recupera as variáveis de ambiente para o processo atual.

Sintaxe

LPCH GetEnvironmentStrings();

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para o bloco de ambiente do processo atual.

Se a função falhar, o valor retornado será NULL.

Comentários

A função GetEnvironmentStrings retorna um ponteiro para um bloco de memória que contém as variáveis de ambiente do processo de chamada (as variáveis de ambiente do sistema e do usuário).

Cada bloco de ambiente contém as variáveis de ambiente no seguinte formato:

Var1=Value1\0
Var2=Value2\0
Var3=Value3\0
...
VarN=ValueN\0\0

O nome de uma variável de ambiente não pode incluir um sinal de igual (=).

Trate essa memória como somente leitura; não modifique-o diretamente. Para adicionar ou alterar uma variável de ambiente, use as funções GetEnvironmentVariable e SetEnvironmentVariable .

Quando o bloco retornado por GetEnvironmentStrings não for mais necessário, ele deverá ser liberado chamando a função FreeEnvironmentStrings .

Observe que a versão ANSI dessa função, GetEnvironmentStringsA, retorna caracteres OEM.

Exemplos

Para obter um exemplo, consulte Alterando variáveis de ambiente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho processenv.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Variáveis de ambiente

FreeEnvironmentStrings

Getenvironmentvariable

Setenvironmentvariable