PFN_WSK_RELEASE_DATA_INDICATION_LIST 콜백 함수(wsk.h)

아티클
03/01/2024

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

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

구문

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

매개 변수

[in] Socket

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

[in] DataIndication

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

반환 값

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

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

설명

연결 지향 또는 수신 대기 소켓의 경우 WSK 애플리케이션은 WskReceiveEvent 또는 WskReceiveFromEvent 이벤트 콜백 함수에서 STATUS_PENDING 반환하여 이전에 보존한 WSK_DATA_INDICATION 구조의 연결된 목록을 해제하기 위해 WskRelease 함수를 호출합니다.

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

요구 사항

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