Funzione GetCommandLineA (processenv.h)

  • Articolo

Recupera la stringa della riga di comando per il processo corrente.

Sintassi

LPSTR GetCommandLineA();

Valore restituito

Il valore restituito è un puntatore alla stringa della riga di comando per il processo corrente.

Commenti

La durata del valore restituito viene gestita dal sistema, le applicazioni non devono liberare o modificare questo valore.

I processi console possono usare gli argomenti argc e argv delle funzioni main o wmain implementando quelli come punto di ingresso del programma. I processi GUI possono usare lpCmdLine argomento delle funzioni WinMain o wWinMain implementando quelli come punto di ingresso del programma.

Per convertire la riga di comando in una matrice di stili argv di stringhe, passare il risultato da GetCommandLineA a CommandLineToArgW.

Nota Il nome dell'eseguibile nella riga di comando fornita dal sistema operativo a un processo non è necessariamente identico a quello nella riga di comando che il processo chiamante fornisce alla funzione CreateProcess . Il sistema operativo può prependare un percorso completo a un nome eseguibile fornito senza un percorso completo.
 

Nota

L'intestazione processenv.h definisce GetCommandLine come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione processenv.h (includono Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CreateProcess

Funzioni di processi e thread