Share via

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

  • Статья

Структура NETCONNECTINFOSTRUCT содержит сведения о производительности сети. Он используется функцией NPGetConnectionPerformance .

Синтаксис

typedef struct _NETCONNECTINFOSTRUCT {
  DWORD cbStructure;
  DWORD dwFlags;
  DWORD dwSpeed;
  DWORD dwDelay;
  DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT, *LPNETCONNECTINFOSTRUCT;

Члены

cbStructure

Размер структуры NETCONNECTINFOSTRUCT в байтах. Он заполняется вызывающим элементом, чтобы указать размер переданной структуры. Поставщик сети должен оставить это поле без изменений и может предположить, что структура достаточно велика, чтобы содержать все поля вплоть до dwOptDataSize включительно.

dwFlags

Это битовая маска, которая может иметь один или несколько следующих флагов.

Значение Значение
WNCON_FORNETCARD
 Если задано значение , возвращаемые сведения будут использоваться для производительности карты netcard, используемой для подключения. Эти сведения возвращаются, если сведения о фактическом подключении недоступны.

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

Если значение не задано, подключение может проходить через маршрутизаторы, которые ограничивают производительность.
WNCON_SLOWLINK
 Если задано значение , соединение в какой-то момент будет установлено через среду, которая обычно работает медленно (например, модем, использующий телефонную линию нормального качества).

Поставщики, возвращающие значение в dwSpeed , не должны задавать этот бит.
WNCON_DYNAMIC
 Если задано значение , некоторые возвращаемые сведения пересчитываются динамически. В этом случае при повторной отправке этого запроса на подключение может быть возвращена другая, более актуальная информация.

dwSpeed

Скорость передачи носителя к сетевому ресурсу в единицах 100 бит/с. Например, ссылка типа "точка — точка" с 1200 baud возвращает 12.

dwDelay

Задержка, возникаемая сетью при отправке информации, в миллисекундах. Иными словами, время между началом отправки данных в сети и временем их получения. Это дополнение к задержке, которая была включена в вычисление dwSpeed, поэтому возвращаемое значение будет равным нулю для доступа к большинству ресурсов.

dwOptDataSize

Рекомендации по размеру данных в байтах, которые наиболее эффективно отправляются по сети, когда приложение выполняет один запрос к сетевому ресурсу. Например, для дискового сетевого ресурса это значение может быть равно 2048 или 512 при записи блока данных.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winnetwk.h