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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnetwk.h
библиотеки	Mpr.lib
DLL	Mpr.dll