NDK_FN_COMPLETE_CONNECT回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCompleteConnect （NDK_FN_COMPLETE_CONNECT）函式會完成異步連線要求。

語法

NDK_FN_COMPLETE_CONNECT NdkFnCompleteConnect;

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

參數

[in] pNdkConnector

NDK 連接器物件的指標（NDK_CONNECTOR）。

[in, optional] DisconnectEvent

選擇性的中斷連線通知回呼 NdkDisconnectEventCallback 函式（NDK_FN_DISCONNECT_EVENT_CALLBACK），提供者在對等中斷連線時呼叫。

[in, optional] DisconnectEventContext

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

[in] RequestCompletion

要求完成回呼的指標 NdkRequestCompletion 函式（NDK_FN_REQUEST_COMPLETION）。

[in, optional] RequestContext

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

傳回值

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

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

言論

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

要求

要求	價值
最低支援的用戶端	不支援，在 NDIS 6.30 和更新版本中支援。
支援的最低伺服器	Windows Server 2012
目標平臺	窗戶
標頭	ndkpi.h （包括 Ndkpi.h）
IRQL	<=DISPATCH_LEVEL