PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST 콜백 함수(wsk.h)

아티클
03/01/2024

WskRelease 함수는 이전에 WSK 애플리케이션에서 보존한 WSK_DATAGRAM_INDICATION 구조체의 연결된 목록을 해제합니다.

WskRelease 는 소켓 유형에 따라 두 가지 방법으로 선언할 수 있습니다. 이 항목에서는 데이터그램 소켓에 대한 WskRelease 에 대해 설명합니다. 연결 지향 또는 수신 대기 소켓은 WskRelease(연결 지향 또는 수신 대기 소켓)를 참조하세요.

구문

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

매개 변수

[in] Socket

데이터가 수신된 소켓의 소켓 개체를 지정하는 WSK_SOCKET 구조체에 대한 포인터입니다.

[in] DatagramIndication

해제할 구조체의 연결된 목록에 대한 포인터입니다. 이 매개 변수의 경우 WSK 애플리케이션은 WskReceiveEvent 또는 WskReceiveFromEvent 이벤트 콜백 함수 에 전달된 DatagramIndication 매개 변수를 지정해야 합니다.

반환 값

WskRelease 는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	구조 목록이 성공적으로 릴리스되었습니다.
STATUS_INVALID_PARAMETER	잘못된 매개 변수가 지정되었습니다.

설명

WSK 애플리케이션은 WskReceiveEvent 또는 WskReceiveFromEvent 이벤트 콜백 함수에서 STATUS_PENDING 반환하여 이전에 유지했던 WSK_DATAGRAM_INDICATION 구조의 연결된 목록을 해제하기 위해 WskRelease 함수 를 호출합니다.

WskCloseSocket 함수를 호출하여 소켓을 닫으면 미해결 보존된 연결된 구조체 목록이 해제되지 않습니다. WSK 애플리케이션은 WskCloseSocket 함수를 호출하여 소켓을 닫기 전에 보존된 모든 연결된 구조 목록을 해제해야 합니다.

요구 사항

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