PFN_WSK_CONNECT回呼函式 (wsk.h)

發行項
02/27/2024

WskConnect 函式會將連線導向或數據流套接字連接到遠端傳輸位址。

語法

PFN_WSK_CONNECT PfnWskConnect;

NTSTATUS PfnWskConnect(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR RemoteAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

參數

[in] Socket

WSK_SOCKET 結構的指標，指定連接到遠端傳輸位址之套接字的套接字物件。

[in] RemoteAddress

結構的指標，指定要連接套接字的遠端傳輸位址。這個指標必須是特定 SOCKADDR 結構類型的指標，對應至建立套接字時所指定的 WSK 應用程式所指定的位址系列。

Flags

此參數保留供系統使用。 WSK 應用程式必須將此參數設定為零。

[in, out] Irp

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

傳回值

WskConnect 會傳回下列其中一個 NTSTATUS 代碼：

傳回碼	Description
STATUS_SUCCESS	套接字已成功連線到遠端傳輸位址。 IRP 將會以成功狀態完成。
STATUS_PENDING	WSK 子系統無法立即連接套接字。 WSK 子系統將套接字連線到遠端傳輸地址之後，將會完成 IRP。線上作業的狀態將會在 IRP 的 [IoStatus.Status ] 字段中傳回。
STATUS_FILE_FORCED_CLOSED	套接字已不再運作。 IRP 將會以失敗狀態完成。 WSK 應用程式必須呼叫 WskCloseSocket 函式，才能儘快關閉套接字。
其他狀態代碼	發生錯誤。 IRP 將會以失敗狀態完成。

備註

WSK 應用程式只能藉由呼叫 WskBind 函式，在先前應用程式系結至本機傳輸位址的連接導向或數據流套接字上呼叫 WskConnect 函式。

針對數據流套接字，一旦成功在數據流套接字上呼叫 WskConnect ，套接字就會認可至連線導向的流程，而且可能不再呼叫接聽套接字函式。

WSK 應用程式可以呼叫 WskSocketConnect 函式，而不是呼叫 WskSocket 函式、 WskBind 函式，然後 呼叫 WskConnect 函式，然後呼叫 WskConnect 函式，以在單一函式調用中建立、系結及連接連接導向套接字。建議您呼叫 WskSocketConnect 函式，除非 WSK 應用程式需要設定套接字選項，或在系結或連接套接字之前發出 I/O 控制作業。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	wsk.h (包含 Wsk.h)
IRQL	<= DISPATCH_LEVEL