Функция WNetGetNetworkInformationA (winnetwk.h)

Статья
08/27/2023

Функция WNetGetNetworkInformation возвращает расширенные сведения о конкретном поставщике сети, имя которого было возвращено предыдущим перечислением сети.

Синтаксис

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

Параметры

[in] lpProvider

Указатель на константную строку, завершающуюся значением NULL, которая содержит имя поставщика сети, для которого требуются сведения.

[out] lpNetInfoStruct

Указатель на структуру NETINFOSTRUCT . Структура описывает характеристики сети.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NO_ERROR.

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

Код возврата	Описание
ERROR_BAD_PROVIDER	Параметр lpProvider не соответствует ни одному работающему поставщику сети.
ERROR_BAD_VALUE	Элемент cbStructure структуры NETINFOSTRUCT не содержит допустимый размер структуры.

Заголовок winnetwk.h определяет WNetGetNetworkInformation в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winnetwk.h
Библиотека	Mpr.lib
DLL	Mpr.dll