NDK_FN_COMPLETE_CONNECT_EX回呼函式 (ndkpi.h)
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
要傳回至 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 | 要求失敗,因為連線建立逾時。這不是災難性或永久失敗的指示,但它會結束此連接器的連接建立。 重要:要求可以以內嵌方式和異步方式使用此狀態代碼失敗。 |
其他狀態代碼 | 發生錯誤。 |
言論
NdkCompleteConnectEx 函式會完成先前呼叫 NdkConnect (NDK_FN_CONNECT) 函式所起始的連接要求。 在對等接受連線要求之後,NDK 取用者會呼叫 NdkCompleteConnectEx。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | NDKPI 2.1 和更新版本支援。 |
支援的最低伺服器 | Windows Server 2022 |
目標平臺 | 窗戶 |
標頭 | ndkpi.h (包括 Ndkpi.h) |
IRQL | <=DISPATCH_LEVEL |