共用方式為


PFN_WSK_LISTEN回呼函式 (wsk.h)

WskListen 函式可讓數據流套接字接聽套接字系結地址的連入連線。

語法

PFN_WSK_LISTEN PfnWskListen;

NTSTATUS PfnWskListen(
  [in]      PWSK_SOCKET Socket,
  [in, out] PIRP Irp
)
{...}

參數

[in] Socket

WSK_SOCKET 結構的指標,指定正在接聽連入連線之數據流套接字的套接字物件。 此套接字先前必須藉由呼叫 WskBind 系結至本機傳輸位址。

[in, out] Irp

WSK 子系統用來以異步方式完成接聽作業的呼叫端配置 IRP 指標。 如需搭配 WSK 函式使用 IRP 的詳細資訊,請參閱 搭配 Winsock 核心函式使用 IRP

傳回值

WskListen 會傳回下列其中一個 NTSTATUS 代碼:

傳回碼 Description
STATUS_SUCCESS
成功接聽連入連線的數據流套接字。 IRP 將會以成功狀態完成。
STATUS_PENDING
IRP 已由 WSK 子系統排入佇列,正在等候串流套接字上的連入連線。
STATUS_FILE_FORCED_CLOSED
套接字已不再運作。 IRP 將會以失敗狀態完成。 WSK 應用程式必須呼叫 WskCloseSocket 函式,才能儘快關閉套接字。
其他狀態代碼
發生錯誤。 IRP 將會以失敗狀態完成。

備註

WSK 應用程式只能藉由呼叫 WskBind 函式,在應用程式先前系結至本機傳輸地址的數據流套接字上呼叫 WskListen 函式。 在數據流套接字上成功呼叫 WskListen 之後,套接字就會認可到接聽套接字流程,而且無法再呼叫連線導向的套接字函式。

規格需求

需求
最低支援的用戶端 Windows 10 (版本 1703)
目標平台 Universal
標頭 wsk.h (包含 Wsk.h)
IRQL <= DISPATCH_LEVEL

另請參閱

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskAccept

WskBind

WskCloseSocket