Función GetCommandLineA (processenv.h)

  • Artículo

Recupera la cadena de la línea de comandos para el proceso actual.

Sintaxis

LPSTR GetCommandLineA();

Valor devuelto

El valor devuelto es un puntero a la cadena de línea de comandos del proceso actual.

Comentarios

El sistema administra la duración del valor devuelto, las aplicaciones no deben liberar ni modificar este valor.

Los procesos de consola pueden usar los argumentos argc y argv de las funciones main o wmain mediante la implementación de como punto de entrada del programa. Los procesos de GUI pueden usar el argumento lpCmdLine de las funciones WinMain o wWinMain mediante la implementación de los mismos como punto de entrada del programa.

Para convertir la línea de comandos en una matriz de estilos argv de cadenas, pase el resultado de GetCommandLineA a CommandLineToArgW.

Nota El nombre del ejecutable en la línea de comandos que el sistema operativo proporciona a un proceso no es necesariamente idéntico al de la línea de comandos que el proceso de llamada proporciona a la función CreateProcess . El sistema operativo puede anteponer una ruta de acceso completa a un nombre ejecutable que se proporciona sin una ruta de acceso completa.
 

Nota

El encabezado processenv.h define GetCommandLine 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

   
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

Vea también

CreateProcess

Funciones de proceso y subproceso