WSAOVERLAPPED 구조체(winsock2.h)

아티클
08/27/2023

WSAOVERLAPPED 구조체는 겹치는 I/O 작업의 시작과 후속 완료 사이의 통신 매체를 제공합니다. WSAOVERLAPPED 구조체는 Windows OVERLAPPED 구조체와 호환됩니다.

구문

typedef struct _WSAOVERLAPPED {
  DWORD    Internal;
  DWORD    InternalHigh;
  DWORD    Offset;
  DWORD    OffsetHigh;
  WSAEVENT hEvent;
} WSAOVERLAPPED, *LPWSAOVERLAPPED;

멤버

Internal

형식: ULONG_PTR

내부용으로 예약된 속성입니다. 내부 멤버는 겹치는 I/O를 구현하는 엔터티에서 내부적으로 사용됩니다. 소켓을 IFS(설치 가능한 파일 시스템) 핸들로 만드는 서비스 공급자의 경우 이 매개 변수는 기본 운영 체제에서 사용됩니다. 다른 서비스 공급자(비 IFS 공급자)는 필요에 따라 이 매개 변수를 자유롭게 사용할 수 있습니다.

InternalHigh

형식: ULONG_PTR

예약되어 있습니다. 겹치는 I/O를 구현하는 엔터티에서 내부적으로 사용됩니다. IFS 핸들로 소켓을 만드는 서비스 공급자의 경우 이 매개 변수는 기본 운영 체제에서 사용됩니다. NonIFS 공급자는 필요에 따라 이 매개 변수를 자유롭게 사용할 수 있습니다.

Offset

형식:DWORD

서비스 공급자가 사용하도록 예약되어 있습니다.

OffsetHigh

형식:DWORD

서비스 공급자가 사용하도록 예약되어 있습니다.

hEvent

형식: HANDLE

I/O 완료 루틴 없이 겹치는 I/O 작업이 실행된 경우(작업의 lpCompletionRoutine 매개 변수가 null로 설정됨) 이 매개 변수는 WSAEVENT 개체에 대한 유효한 핸들을 포함하거나 null이어야 합니다. 호출의 lpCompletionRoutine 매개 변수가 null이 아닌 경우 애플리케이션은 필요에 따라 이 매개 변수를 자유롭게 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	winsock2.h