Função GetCommandLineA (processenv.h)

  • Artigo

Recupera a cadeia de caracteres de linha de comando para o processo atual.

Sintaxe

LPSTR GetCommandLineA();

Valor retornado

O valor retornado é um ponteiro para a cadeia de caracteres de linha de comando para o processo atual.

Comentários

O tempo de vida do valor retornado é gerenciado pelo sistema, os aplicativos não devem liberar ou modificar esse valor.

Os processos de console podem usar os argumentos argc e argv das funções main ou wmain implementando-os como o ponto de entrada do programa. Os processos de GUI podem usar o argumento lpCmdLine das funções WinMain ou wWinMain implementando-as como o ponto de entrada do programa.

Para converter a linha de comando em uma matriz de cadeias de caracteres de estilo argv , passe o resultado de GetCommandLineA para CommandLineToArgW.

Nota O nome do executável na linha de comando que o sistema operacional fornece a um processo não é necessariamente idêntico ao da linha de comando que o processo de chamada fornece à função CreateProcess . O sistema operacional pode anexar um caminho totalmente qualificado a um nome executável fornecido sem um caminho totalmente qualificado.
 

Observação

O cabeçalho processenv.h define GetCommandLine 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

   
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

CreateProcess

Funções de thread e processo