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	설정된 경우 반환되는 정보는 연결에 사용되는 넷카드의 성능을 위한 것입니다. 실제 연결에 대한 정보를 사용할 수 없는 경우 이 정보가 반환됩니다. 설정하지 않으면 반환되는 정보는 리소스와의 현재 연결에 대한 것이며 라우팅 저하를 고려합니다.
WNCON_NOTROUTED	설정된 경우 연결이 라우팅되는 것으로 처리되지 않습니다. 즉, 성능을 예측할 때 라우팅은 고려되지 않습니다. 즉, 실제 성능이 반환된 정보보다 훨씬 적을 수 있습니다. 설정하지 않으면 연결이 성능을 제한하는 라우터를 통과할 수 있습니다.
WNCON_SLOWLINK	설정된 경우 연결은 일반적으로 느린 매체(예: 일반 품질 전화선을 사용하는 모뎀)를 통해 연결되는 것으로 알려져 있습니다. dwSpeed의 값을 반환하는 공급자는 이 비트를 설정할 필요가 없습니다.
WNCON_DYNAMIC	설정된 경우 반환되는 정보 중 일부는 동적으로 다시 계산됩니다. 이 경우 연결에서 이 요청을 재발행하면 다른 최신 정보를 반환할 수 있습니다.

dwSpeed

100bps 단위로 네트워크 리소스에 대한 미디어의 속도입니다. 예를 들어 1,200개 전송된 지점 및 지점 간의 링크는 12를 반환합니다.

dwDelay

정보를 보낼 때 네트워크에서 도입한 지연(밀리초)입니다. 즉, 네트워크가 데이터를 보내기 시작한 시간과 수신된 시간 사이의 시간입니다. 이는 dwSpeed 계산에 통합된 대기 시간에 추가되므로 반환되는 값은 대부분의 리소스에 액세스하기 위해 0이 됩니다.

dwOptDataSize

애플리케이션이 네트워크 리소스에 단일 요청을 할 때 네트워크를 통해 가장 효율적으로 전송되는 데이터 크기(바이트)에 대한 권장 사항입니다. 예를 들어 디스크 네트워크 리소스의 경우 데이터 블록을 작성할 때 이 값은 2048 또는 512일 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	winnetwk.h