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

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

  • Статья

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

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

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

    Пример: NetGroupAdd

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

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

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

    Пример: NetGroupEnum