Função FreeEnvironmentStringsA (processenv.h)
Libera um bloco de cadeias de caracteres de ambiente.
Sintaxe
BOOL FreeEnvironmentStringsA(
LPCH penv
);
Parâmetros
penv
Um ponteiro para um bloco de cadeias de caracteres de ambiente. O ponteiro para o bloco deve ser obtido chamando a função GetEnvironmentStrings .
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
Se você usou a versão ANSI de GetEnvironmentStrings, use a versão ANSI de FreeEnvironmentStrings. Da mesma forma, se você usou a versão Unicode de GetEnvironmentStrings, use a versão Unicode de FreeEnvironmentStrings.
Exemplos
Para obter um exemplo, consulte Alterando variáveis de ambiente.
Observação
O cabeçalho processenv.h define FreeEnvironmentStrings como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de