Função GetCommandLineW (processenv.h)

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

Sintaxe

LPWSTR GetCommandLineW();

Valor de retorno

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

Observações

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 do principal ou funções de 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 estilo de argv de cadeias de caracteres, passe o resultado de GetCommandLineW para CommandLineToArgvW.

Observação 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 preparar um caminho totalmente qualificado para um nome executável fornecido sem um caminho totalmente qualificado.

 

Nota

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 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

Consulte também

CreateProcess

Funções de processo e thread