Função SetEnvironmentVariable (winbase.h)

Define o conteúdo da variável de ambiente especificada para o processo atual.

Sintaxe

BOOL SetEnvironmentVariable(
  [in]           LPCTSTR lpName,
  [in, optional] LPCTSTR lpValue
);

Parâmetros

[in] lpName

O nome da variável de ambiente. O sistema operacional criará a variável de ambiente se ela não existir e lpValue não for NULL.

[in, optional] lpValue

O conteúdo da variável de ambiente. O tamanho máximo de uma variável de ambiente definida pelo usuário é de 32.767 caracteres. Para obter mais informações, consulte Variáveis de ambiente.

Windows Server 2003 e Windows XP: O tamanho total do bloco de ambiente de um processo pode não exceder 32.767 caracteres.

Se esse parâmetro for NULL, a variável será excluída do ambiente do processo atual.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função não tem efeito sobre as variáveis de ambiente do sistema ou as variáveis de ambiente de outros processos.

Exemplos

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

Requisitos

Confira também

Variáveis de ambiente

Getenvironmentvariable