NDK_FN_COMPLETE_CONNECT_EX回呼函式 (ndkpi.h)

發行項
02/26/2024

NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) 函式會完成異步連線要求。

語法

NDK_FN_COMPLETE_CONNECT_EX NdkFnCompleteConnectEx;

NTSTATUS NdkFnCompleteConnectEx(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional] PVOID DisconnectEventContext,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

參數

[in] pNdkConnector

NDK 連接器物件的指標， (NDK_CONNECTOR) 。

[in, optional] DisconnectEvent

選擇性中斷連線通知回呼函式 NdkDisconnectEventCallbackEx 函式NDK_FN_DISCONNECT_EVENT_CALLBACK_EX的進入點。當對等中斷連線時，提供者會呼叫此回呼函式。

[in, optional] DisconnectEventContext

要傳回至 DisconnectEvent 參數中指定的 NdkDisconnectEventCallback 函式的內容值。

[in] RequestCompletion

要求完成回呼 NdkRequestCompletion 函式的指標， (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

提供者傳回 至 NdkRequestCompletion 函 式的內容值。這個值是在 RequestCompletion 參數中指定。

傳回值

NDK_FN_COMPLETE_CONNECT函式會傳回下列其中一個NTSTATUS代碼。

傳回碼	Description
STATUS_SUCCESS	要求已順利完成。
STATUS_PENDING	要求擱置中。提供者會呼叫 RequestCompletion 參數中指定的 NdkRequestCompletion 函式，以異步方式完成要求。
STATUS_CONNECTION_INVALID	要求失敗，因為佇列配對未連線。重要：要求可以內嵌失敗，以及以異步方式使用此狀態代碼。
STATUS_CONNECTION_ABORTED	接受的對等已放棄擱置的連線建立。
STATUS_IO_TIMEOUT	要求失敗，因為連線建立逾時。這不是重大或永久失敗的指示，但它會結束此連接器的連線建立。重要：要求可以內嵌失敗，以及以異步方式使用此狀態代碼。
其他狀態代碼	發生錯誤。

備註

NdkCompleteConnectEx 函式會完成先前呼叫 NdkConnect (NDK_FN_CONNECT) 函式所起始的連接要求。 NDK 取用者會在對等接受連線要求之後呼叫 NdkCompleteConnectEx 。

規格需求

需求	值
最低支援的用戶端	NDKPI 2.1 和更新版本支援。
最低支援的伺服器	Windows Server 2022
目標平台	Windows
標頭	ndkpi.h (包含 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL