__getmainargs, __wgetmainargs

Appelle l’analyse de ligne de commande et recopie les arguments de main() dans les pointeurs transmis.

Syntaxe

int __getmainargs(
    int * argc,
   char *** argv,
   char *** env,
   int doWildCard,
_startupinfo * startInfo);

int __wgetmainargs (
   int *argc,
   wchar_t ***argv,
   wchar_t ***env,
   int doWildCard,
   _startupinfo * startInfo)

Paramètres

argc
Entier qui contient le nombre d’arguments qui se suivent dans argv. Le paramètre argc est toujours supérieur ou égal à 1.

argv
Tableau de chaînes terminées par le caractère NULL qui représentent les arguments de ligne de commande entrés par l’utilisateur du programme. Par convention, argv[0] est la commande avec laquelle le programme est appelé, argv[1] est le premier argument de ligne de commande, et ainsi de suite, jusqu’à argv[argc], qui est toujours NULL. Le premier argument de ligne de commande est toujours argv[1] et le dernier argv[argc - 1].

env
Tableau de chaînes représentant les variables définies dans l’environnement de l’utilisateur. Ce tableau est arrêté par une NULL entrée.

doWildCard
Entier qui, avec la valeur 1, développe les caractères génériques dans les arguments de ligne de commande, ou qui, avec la valeur 0, n’a aucun effet.

startInfo
Autres informations à transmettre à la DLL CRT.

Valeur retournée

0 en cas de réussite ; valeur négative en cas d’échec.

Notes

Utilisez __getmainargs sur les plateformes à caractères non larges et __wgetmainargs sur les plateformes à caractères larges (Unicode).

Spécifications

Routine	En-tête requis
__getmainargs	internal.h
__wgetmainargs	internal.h