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


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

Функция 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

См. также раздел

NETINFOSTRUCT

NETRESOURCE

WNetEnumResource

WNetGetProviderName

WNetOpenUm

Общие сведения о сети Windows (WNet)

Сетевые функции Windows