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

Cette rubrique décrit la configuration requise 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 de 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 grandes pour contenir la ou les structures d’informations retournées, ainsi que les chaînes vers lesquelles leurs membres pointent. Si vous ne spécifiez pas une 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 consultatif de longueur maximale des données, prefmaxlen. 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 prefmaxlen , 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.