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

Confira também

Variáveis de ambiente

FreeEnvironmentStrings

Getenvironmentvariable

Setenvironmentvariable