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