Estructura NETCONNECTINFOSTRUCT (winnetwk.h)

La estructura NETCONNECTINFOSTRUCT contiene información sobre el rendimiento de una red. La función NPGetConnectionPerformance la usa.

Sintaxis

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

Miembros

cbStructure

Tamaño de la estructura NETCONNECTINFOSTRUCT , en bytes. Esto se rellena por el autor de la llamada para indicar el tamaño de la estructura pasada. El proveedor de red debe dejar este campo sin cambios y puede suponer que la estructura es lo suficientemente grande como para contener todos los campos hasta y incluir dwOptDataSize.

dwFlags

Se trata de una máscara de bits que puede tener una o varias de las marcas siguientes.

Valor	Significado
WNCON_FORNETCARD	Si se establece, la información devuelta es para el rendimiento del netcard usado para la conexión. Esta información se devuelve si la información sobre la conexión real no está disponible. Si no se establece, la información devuelta es para la conexión actual con el recurso, teniendo en cuenta cualquier degradación del enrutamiento.
WNCON_NOTROUTED	Si se establece, la conexión no se trata como enrutada. En otras palabras, el enrutamiento no se tiene en cuenta al calcular el rendimiento. Esto significa que el rendimiento real puede ser mucho menor que la información devuelta. Si no se establece, la conexión puede pasar por enrutadores que limiten el rendimiento.
WNCON_SLOWLINK	Si se establece, la conexión se conoce en algún momento como un medio que suele ser lento (por ejemplo, un módem que usa una línea telefónica de calidad normal). Los proveedores que devuelven un valor en dwSpeed no tienen que establecer este bit.
WNCON_DYNAMIC	Si se establece, parte de la información devuelta se vuelve a calcular dinámicamente. Si es así, volver a emitir esta solicitud en la conexión puede devolver información diferente, más actual.

dwSpeed

Velocidad del medio al recurso de red en unidades de 100bps. Por ejemplo, un vínculo de punto a punto de 1200 baudios devuelve 12.

dwDelay

Retraso introducido por la red al enviar información, en milisegundos. Es decir, el tiempo entre el momento en que la red comienza a enviar datos y la hora en que se recibe. Esto se suma a cualquier latencia que se haya incorporado en el cálculo de dwSpeed, por lo que el valor devuelto será cero para acceder a la mayoría de los recursos.

dwOptDataSize

Recomendación para el tamaño de los datos, en bytes, que se envía de forma más eficaz a través de la red cuando una aplicación realiza una única solicitud al recurso de red. Por ejemplo, para un recurso de red de disco, este valor puede ser 2048 o 512 al escribir un bloque de datos.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winnetwk.h