GetCommandLineW, fonction (processenv.h)

Récupère la chaîne de ligne de commande pour le processus actuel.

Syntaxe

LPWSTR GetCommandLineW();

Valeur de retour

La valeur de retour est un pointeur vers la chaîne de ligne de commande du processus actuel.

Remarques

La durée de vie de la valeur retournée est gérée par le système. Les applications ne doivent pas libérer ou modifier cette valeur.

Les processus de console peuvent utiliser les arguments argc et argv des fonctions main ou wmain en les implémentant en tant que point d’entrée du programme. Les processus gui peuvent utiliser l’argument lpCmdLine des fonctions WinMain ou wWinMain en implémentant celles-ci en tant que point d’entrée du programme.

Pour convertir la ligne de commande en tableau de chaînes de style argv , passez le résultat de GetCommandLineW à CommandLineToArgvW.

Note Le nom de l’exécutable dans la ligne de commande que le système d’exploitation fournit à un processus n’est pas nécessairement identique à celui de la ligne de commande que le processus appelant donne à la fonction CreateProcess . Le système d’exploitation peut ajouter un chemin d’accès complet à un nom exécutable fourni sans chemin d’accès complet.
 

Notes

L’en-tête processenv.h définit GetCommandLine en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête processenv.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CreateProcess

Fonctions de processus et de thread