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 |
---|---|
|
成功接聽連入連線的數據流套接字。 IRP 將會以成功狀態完成。 |
|
IRP 已由 WSK 子系統排入佇列,正在等候串流套接字上的連入連線。 |
|
套接字已不再運作。 IRP 將會以失敗狀態完成。 WSK 應用程式必須呼叫 WskCloseSocket 函式,才能儘快關閉套接字。 |
|
發生錯誤。 IRP 將會以失敗狀態完成。 |
備註
WSK 應用程式只能藉由呼叫 WskBind 函式,在應用程式先前系結至本機傳輸地址的數據流套接字上呼叫 WskListen 函式。 在數據流套接字上成功呼叫 WskListen 之後,套接字就會認可到接聽套接字流程,而且無法再呼叫連線導向的套接字函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1703) |
目標平台 | Universal |
標頭 | wsk.h (包含 Wsk.h) |
IRQL | <= DISPATCH_LEVEL |