Longueurs des mémoires tampons des fonctions de gestion du réseau

Cette rubrique décrit les conditions requises pour les longueurs de mémoire tampon de fonction lorsqu’elles sont utilisées avec les API de gestion réseau.

Les applications qui spécifient des tailles de mémoire tampon lors de l’appel des fonctions d’énumération de gestion réseau (et diverses fonctions de récupération de données) doivent spécifier des mémoires tampons suffisamment volumineuses pour contenir la structure d’informations retournée (ou les structures) ainsi que les chaînes auxquelles leurs membres pointent. Si vous ne spécifiez pas de mémoire tampon suffisamment grande pour recevoir toutes les entrées disponibles, la fonction retourne ERROR_MORE_DATA. Les appels d’énumération ne retournent pas d’entrées partielles.

Certaines fonctions de gestion réseau prennent un paramètre de longueur maximale de données consultatif, préfmaxlen . Ce paramètre permet à une application de suggérer le nombre d’octets que le serveur doit retourner à partir d’un appel de fonction.

Si vous spécifiez la valeur MAX_PREFERRED_LENGTH dans le paramètre préfmaxlen, les fonctions de gestion réseau allouent la quantité de mémoire requise pour les données.

Pour plus d’informations, consultez mémoires tampons de fonction de gestion réseau.