PFN_WSK_ABORT_EVENT 콜백 함수(wsk.h)

아티클
08/08/2023

WskAbortEvent 이벤트 콜백 함수는 조건부 수락 모드가 설정된 수신 대기 소켓에서 들어오는 연결 요청이 삭제되었음을 WSK 애플리케이션에 알린 것입니다.

구문

PFN_WSK_ABORT_EVENT PfnWskAbortEvent;

NTSTATUS PfnWskAbortEvent(
  [in, optional] PVOID SocketContext,
  [in]           PWSK_INSPECT_ID InspectID
)
{...}

매개 변수

[in, optional] SocketContext

들어오는 연결 요청이 수신된 수신 소켓의 소켓 컨텍스트에 대한 포인터입니다. WSK 애플리케이션은 WskSocket 함수를 호출하여 수신 대기 소켓을 만들 때 WSK 하위 시스템에 대한 이 포인터를 제공했습니다.

[in] InspectID

WSK_INSPECT_ID 구조체에 대한 포인터입니다. 구조체의 내용은 삭제된 들어오는 연결 요청을 식별합니다.

반환 값

WSK 애플리케이션의 WskAbortEvent 이벤트 콜백 함수는 항상 STATUS_SUCCESS 반환해야 합니다.

설명

WSK 하위 시스템은 다음 조건이 충족되는 경우에만 WSK 애플리케이션의 WskAbortEvent 이벤트 콜백 함수를 호출합니다.

WSK 애플리케이션은 조건부 수락 모드가 사용하도록 설정된 수신 대기 소켓을 만들었습니다.
수신 소켓에서 들어오는 연결 요청이 수신되었으며 WSK 하위 시스템은 WSK 애플리케이션의 WskInspectEvent 이벤트 콜백 함수를 호출했습니다.
WSK 애플리케이션은 들어오는 연결 요청에 대한 WskAbortEvent 이벤트 콜백 함수에서 WskInspectPend 또는 WskInspectAccept를 반환했습니다.
들어오는 연결 요청이 완전히 설정되기 전에 로컬 또는 원격으로 삭제되었습니다.

WSK 하위 시스템이 WSK 애플리케이션의 WskAbortEvent 이벤트 콜백 함수를 호출하는 경우 애플리케이션은 들어오는 연결 요청에 대한 검사를 종료해야 합니다. 연결 요청은 InspectID 매개 변수가 가리키는 WSK_INSPECT_ID 구조체의 내용으로 식별됩니다.

WSK 애플리케이션이 중단된 들어오는 연결 요청에서 WskInspectComplete 함수를 호출하는 경우 WskInspectAccept 가 Action 매개 변수에 지정된 경우에도 연결이 설정되지 않습니다.

WSK 애플리케이션은 SO_CONDITIONAL_ACCEPT 소켓 옵션을 사용하도록 설정하여 수신 대기 소켓에서 조건부 수락 모드를 사용하도록 설정할 수 있습니다. 들어오는 연결을 조건부로 수락하는 방법에 대한 자세한 내용은 수신 대기 및 수신 허용 Connections 참조하세요.

WSK 하위 시스템은 IRQL <= DISPATCH_LEVEL WSK 애플리케이션의 WskAbortEvent 이벤트 콜백 함수를 호출합니다.

WSK 애플리케이션의 WskAbortEvent 이벤트 콜백 함수는 WSK 완료 또는 이벤트 콜백 함수의 컨텍스트에서 다른 WSK 요청이 완료될 때까지 기다리지 않아야 합니다. 콜백은 다른 WSK 요청을 시작할 수 있지만(DISPATCH_LEVEL 시간이 너무 많이 소요되지 않는다고 가정) 콜백이 IRQL = PASSIVE_LEVEL 호출되는 경우에도 완료될 때까지 기다리지 않아야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	Windows
헤더	wsk.h(Wsk.h 포함)
IRQL	<= DISPATCH_LEVEL