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 de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero Para obter informações de erro estendidas, chame GetLastError.
Observações
Se você usou a versão ANSI da função GetEnvironmentStrings, use a versão ANSI do FreeEnvironmentStrings. Da mesma forma, se você usou a versão Unicode do GetEnvironmentStrings, use a versão Unicode de FreeEnvironmentStrings.
Exemplos
Para obter um exemplo, consulte Alterando variáveis de ambiente.
Nota
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 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 XP [aplicativos da área de trabalho | Aplicativos UWP] |
| servidor com suporte mínimo | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da 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 |
| de DLL |
Kernel32.dll |