Поделиться через


Буферы функций управления сетью

Библиотека времени выполнения RPC обрабатывает буферы, необходимые для 32-разрядных сетевых функций управления получением данных, следующим образом:

  • Отправка данных на сервер (данные, заданные параметрами [in]).

    Вызывающий объект должен выделить и освободить буфер для соответствующей информационной структуры (или структур) и передать в функцию переменную указателя. Вызывающей объекту не нужно указывать длину буфера.

    Пример: NetGroupAdd

  • Получение данных с сервера (данные, заданные параметрами [out]).

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

    Когда вызывающий объект завершит обработку возвращенных сведений, он должен освободить память, выделенную системой, вызвав функцию NetApiBufferFree . Дополнительные сведения об указании размеров буфера см. в разделе Длина буфера функции управления сетью.

    Пример: NetGroupEnum