Struttura NETCONNECTINFOSTRUCT (winnetwk.h)

La struttura NETCONNECTINFOSTRUCT contiene informazioni sulle prestazioni di una rete. Viene usato dalla funzione NPGetConnectionPerformance .

Sintassi

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

Members

cbStructure

Dimensioni della struttura NETCONNECTINFOSTRUCT , in byte. Questa operazione viene compilata dal chiamante per indicare le dimensioni della struttura passata. Il provider di rete deve lasciare invariato questo campo e può presumere che la struttura sia abbastanza grande per contenere tutti i campi fino a e inclusi dwOptDataSize.

dwFlags

Si tratta di una maschera bit che può avere uno o più flag seguenti.

Valore	Significato
WNCON_FORNETCARD	Se impostata, le informazioni restituite sono per le prestazioni della netcard usata per la connessione. Queste informazioni vengono restituite se le informazioni sulla connessione effettiva non sono disponibili. Se non è impostato, le informazioni restituite sono per la connessione corrente con la risorsa, con qualsiasi riduzione del routing presa in considerazione.
WNCON_NOTROUTED	Se impostata, la connessione non viene considerata come instradata. In altre parole, il routing non viene considerato quando si stimano le prestazioni. Ciò significa che le prestazioni effettive possono essere molto meno delle informazioni restituite. Se non è impostato, la connessione potrebbe essere in corso attraverso router che limitano le prestazioni.
WNCON_SLOWLINK	Se impostata, la connessione è nota a un certo punto per essere su un supporto che in genere è lento (ad esempio, un modem che usa una normale linea telefonica di qualità). I provider che restituiscono un valore in dwSpeed non devono impostare questo bit.
WNCON_DYNAMIC	Se impostato, alcune delle informazioni restituite vengono ricalcolate dinamicamente. In caso affermativo, la ristampa di questa richiesta sulla connessione può restituire informazioni diverse, più correnti.

dwSpeed

Velocità del supporto alla risorsa di rete in unità di 100bps. Ad esempio, un collegamento da punto a 1.200 baud restituisce 12.

dwDelay

Ritardo introdotto dalla rete durante l'invio di informazioni, in millisecondi. In altre parole, il tempo compreso tra l'avvio della rete e l'ora in cui viene ricevuta. Oltre a qualsiasi latenza incorporata nel calcolo di dwSpeed, il valore restituito sarà zero per l'accesso alla maggior parte delle risorse.

dwOptDataSize

Una raccomandazione per le dimensioni dei dati, in byte, che viene inviata in modo più efficiente tramite la rete quando un'applicazione effettua una singola richiesta alla risorsa di rete. Ad esempio, per una risorsa di rete su disco, questo valore potrebbe essere 2048 o 512 quando si scrive un blocco di dati.

Requisiti

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winnetwk.h