Длина буфера функции управления сетью

  • Статья

В этом разделе рассматриваются требования к длине буфера функций при использовании с API управления сетью.

Приложения, которые указывают размеры буферов при вызове функций перечисления управления сетью (и различных функций извлечения данных), должны указывать буферы, достаточно большие для хранения возвращаемой структуры информации (или структур) плюс строки, на которые указывают их члены. Если не указать достаточно большой буфер для получения всех доступных записей, функция возвращает ERROR_MORE_DATA. Вызовы перечисления не возвращают частичные записи.

Некоторые функции управления сетью принимают параметр prefmaxlen( предварительная длина данных). Этот параметр позволяет приложению предложить количество байтов, возвращаемых сервером при вызове функции.

Если указать значение MAX_PREFERRED_LENGTH в параметре prefmaxlen , функции управления сетью выделяют объем памяти, необходимый для данных.

Дополнительные сведения см. в разделе Буферы функций управления сетью.