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
要傳回至 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 |