На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

NETCONNECTINFOSTRUCT



The NETCONNECTINFOSTRUCT structure contains information about the expected performance of a connection used to access a network resource. In the dwSpeed, dwDelay or dwOptDataSize members, a value of zero means that no information is available. In the dwSpeed or dwDelay member, a value of one means that the actual value is greater than can be represented in the unit.

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


Members

cbStructure

The size, in bytes, of the NETCONNECTINFOSTRUCT structure. This value is supplied by the caller to indicate the size of the structure.

dwFlags

A bit mask. This member can be one or more of the following flags.

Value Meaning
WNCON_FORNETCARD If this flag is set, information is being returned for the performance of the network card, in the absence of information about the actual connection. If this flag is not set, information is being returned for the current connection with the resource, with any routing degradation taken into consideration.
WNCON_NOTROUTED If set, the connection is not being routed. If the flag is not set, the connection may be going through routers that limit performance. Consequently, if WNCON_FORNETCARD is set, actual performance may be much less than the information returned.
WNCON_SLOWLINK If the flag is set, the connection is over a medium that is typically slow (for example, over a modem using a normal quality phone line).
WNCON_DYNAMIC If the flag is set, some of the information being returned is dynamically recalculated, so reissuing this request may return different or more current information.


dwSpeed

The speed of the media to the network resource in units of 100 bits per second (bps) For example, a 1200 baud point-to-point link returns 12.

dwDelay

The one-way delay introduced by the network when sending information (that is, the time between when data starts being sent and the time that it starts being received), in milliseconds. This delay is additional to any latency that was incorporated into the calculation of dwSpeed, so the value returned will be zero for accessing most resources.

dwOptDataSize

A recommendation for the size of data, in bytes, that is most efficiently sent through the network when an application makes a single request to the network resource. For example, for a disk network resource, this value might be 2048 or 512 when writing a block of data



See Also

MultinetGetConnectionPerformance, NetUserAdd


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

NETCONNECTINFOSTRUCT



Структура NETCONNECTINFOSTRUCT содержит информацию об ожидаемом исполнении связи использованной, чтобы иметь доступ к сетевому ресурсу. На dwSpeed, dwDelay или участниках dwOptDataSize, величина нуля означает, что никакая информация не доступна. В dwSpeed или элементе dwDelay, величина одного означает, что фактическая величина больше, чем может быть представлено на устройстве.

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


Участники

cbStructure

Размер, в байтах, структуры NETCONNECTINFOSTRUCT. Эта величина поставлена вызывающим оператором, чтобы указывать размер структуры.

dwFlags

Немного маска. Этот элемент может быть одно или более из следующего флагов.

Значение Величины
WNCON_FORNETCARD Если этот флаг установлен, информация возвращается для исполнения сетевой карты, при отсутствии информации о фактической связи. Если этот флаг не установлен, информация возвращается для текущей связи с ресурсом, с любым разложением маршрутизации принявшим во внимание.
WNCON_NOTROUTED Если установлено, связь не направляется. Если флаг не установлен, связь может собраться через маршрутизаторы, которые ограничивают исполнение. Следовательно, если WNCON_FORNETCARD установлен, фактическое исполнение может быть значительно менее чем возвращанная информация.
WNCON_SLOWLINK Если флаг установлен, связь - над серединой, которая обычно медленная (например, над модемом, использовавшим нормальную телефонную линию качества).
WNCON_DYNAMIC Если флаг установлен, некоторая информация, возвращанная динамически пересчитана, так что выпуская повторно этот запрос может возвращать другую или более текущую информацию.


dwSpeed

Скорость носителя в сетевой ресурс на устройствах 100 битов в сукунду (бит в сек) Например, 1200 возвратов сканирующей связи бода 12.

dwDelay

Односторонняя задержка вводилась сетью при посылке информации (то есть, время между когда данные начинает, послано и время, которое он начинает, получен), в течение миллисекунд. Эта задержка дополнительная в любом времени ожидания, которое было включено в вычисление dwSpeed, так что возвращанная величина будет нулем для доступа большинство ресурсов.

dwOptDataSize

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



Смотри Также

MultinetGetConnectionPerformance, NetUserAdd


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz