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

媒體到網路資源的速度，單位為 100bps。 例如，1，200 個傳輸點對點連結會傳回 12。

dwDelay

傳送資訊時網路所導入的延遲，以毫秒為單位。 換句話說，網路開始傳送資料的時間及其接收時間之間的時間。 除了納入 dwSpeed計算的任何延遲之外，傳回的值也會是零，以存取大部分的資源。

dwOptDataSize

當應用程式對網路資源提出單一要求時，最有效率地透過網路傳送的資料大小建議。 例如，針對磁片網路資源，當寫入資料區塊時，此值可能是 2048 或 512。

規格需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	winnetwk.h