_setmaxstdio

Définit un maximum pour le nombre de fichiers ouverts simultanément au niveau stdio.

int _setmaxstdio(
   int newmax 
);

Paramètres

  • newmax
    Nouveau maximum pour le nombre de fichiers ouverts simultanément au niveau stdio.

Valeur de retour

Retourne newmax si l'opération réussit ; sinon, –1 .

Si newmax est inférieur à _IOB_ENTRIES ou supérieur au nombre maximal de descripteurs disponibles dans le système d'exploitation, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction renvoie -1 et définit errno à la valeur EINVAL.

Pour plus d'informations sur ces éléments et autres codes d'erreur, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Notes

La fonction _setmaxstdio change la valeur maximale du nombre de fichiers qui peuvent être ouverts simultanément au niveau stdio.

Le runtime E/S C prend maintenant en charge beaucoup plus de fichiers ouverts sur les plateformes Win32 que dans les versions antérieures. Jusqu'à 2.048 fichiers peuvent être ouverts simultanément sur lowio de niveau (autrement dit, ouverts et accessibles au moyen de _open, _read, _write, etc. famille des fonctions d'E/S). Jusqu'à 512 fichiers peuvent être ouverts simultanément sur stdio level (autrement dit, ouverts et accessibles au moyen de fopen, fgetc, fputc, etc. famille des fonctions d'E/S). La limite de 512 fichiers ouverts au niveau de stdio peut être augmentée à 2.048 au moyen de la fonction _setmaxstdio.

Étant donné que des fonctions de niveau stdio, telles que fopen, sont générées à partir de fonctions lowio, la valeur maximale de 2.048 est une limite supérieure difficile pour le même nombre de fichiers ouverts accessibles via la bibliothèque Runtime C.

Notes

Cette limite supérieure peut être au delà de ce qui est pris en charge par une plateforme et une configuration spécifiques Win32.

Configuration requise

Routine

En-tête requis

_setmaxstdio

<stdio.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Exemple

Consultez _getmaxstdio pour un exemple de l'utilisation de _setmaxstdio.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Voir aussi

Référence

E/S de flux