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


Структура NETINFOSTRUCT (winnetwk.h)

Структура NETINFOSTRUCT содержит сведения, описывающие поставщика сети, возвращаемые функцией WNetGetNetworkInformation .

Синтаксис

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Члены

cbStructure

Тип: DWORD

Размер структуры NETINFOSTRUCT (в байтах). Вызывающий объект должен указать это значение, чтобы указать размер передаваемой структуры. После возврата он имеет размер структуры заполнен.

dwProviderVersion

Тип: DWORD

Номер версии программного обеспечения поставщика сети.

dwStatus

Тип: DWORD

Текущее состояние программного обеспечения поставщика сети. Этот элемент может быть одним из следующих значений.

Значение Значение
NO_ERROR
Сеть запущена.
ERROR_NO_NETWORK
Сеть недоступна.
ERROR_BUSY
В настоящее время сеть не может обслуживать запросы, но она должна стать доступной в ближайшее время. (Обычно это значение указывает, что сеть запускается.)

dwCharacteristics

Тип: DWORD

Характеристики программного обеспечения поставщика сети.

Это значение равно нулю.

Windows Me/98/95: Этот элемент может быть одним или несколькими из следующих значений.

Значение Значение
NETINFO_DLL16
Сетевой поставщик работает как 16-разрядный сетевой драйвер Windows.
NETINFO_DISKRED
Поставщику сети требуется перенаправленное локальное дисковое устройство для доступа к файловой системе сервера.
NETINFO_PRINTERRED
Поставщику сети требуется перенаправленный локальный порт принтера для доступа к файловой системе сервера.

dwHandle

Тип: ULONG_PTR

Дескриптор экземпляра для сетевого поставщика или 16-разрядного сетевого драйвера Windows.

wNetType

Тип: WORD

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

dwPrinters

Тип: DWORD

Набор битовых флагов, указывающих допустимые номера печати для перенаправления локальных принтеров с битом низкого порядка, соответствующим LPT1.

Windows Me/98/95: Это значение всегда равно –1.

dwDrives

Тип: DWORD

Набор битовых флагов, указывающих допустимые локальные дисковые устройства для перенаправления дисков, с битом низкого порядка, соответствующим A:.

Windows Me/98/95: Это значение всегда равно –1.

Комментарии

Структура NETINFOSTRUCT содержит сведения, описывающие сеть, такие как версия программного обеспечения поставщика сети и текущее состояние сети.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winnetwk.h

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

WNetGetNetworkInformation

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

Сетевые структуры Windows