Función FreeEnvironmentStringsA (processenv.h)
Libera un bloque de cadenas de entorno.
Sintaxis
BOOL FreeEnvironmentStringsA(
LPCH penv
);
Parámetros
penv
Puntero a un bloque de cadenas de entorno. El puntero al bloque debe obtenerse llamando a la función GetEnvironmentStrings .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si usó la versión ANSI de GetEnvironmentStrings, asegúrese de usar la versión ANSI de FreeEnvironmentStrings. Del mismo modo, si usó la versión Unicode de GetEnvironmentStrings, asegúrese de usar la versión Unicode de FreeEnvironmentStrings.
Ejemplos
Para obtener un ejemplo, consulte Cambio de variables de entorno.
Nota
El encabezado processenv.h define FreeEnvironmentStrings como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | processenv.h (incluye Windows.h en Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |