NDK_FN_COMPLETE_CONNECT_EX fungsi panggilan balik (ndkpi.h)

Artikel
08/07/2023

Fungsi NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) menyelesaikan permintaan koneksi asinkron.

Sintaks

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
)
{...}

Parameter

[in] pNdkConnector

Penunjuk ke objek konektor NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Titik masuk untuk fungsi panggilan balik pemberitahuan pemutusan opsional NDK_FN_DISCONNECT_EVENT_CALLBACK_EX fungsi NdkDisconnectEventCallbackEx. Penyedia memanggil fungsi panggilan balik ini ketika peer terputus.

[in, optional] DisconnectEventContext

Nilai konteks untuk diteruskan kembali ke fungsi NdkDisconnectEventCallback yang ditentukan dalam parameter DisconnectEvent .

[in] RequestCompletion

Penunjuk ke panggilan balik penyelesaian permintaan fungsi NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Nilai konteks yang diteruskan penyedia kembali ke fungsi NdkRequestCompletion . Nilai ini ditentukan dalam parameter RequestCompletion .

Nilai kembali

Fungsi NDK_FN_COMPLETE_CONNECT mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Permintaan berhasil diselesaikan.
STATUS_PENDING	Permintaan tertunda. Penyedia akan memanggil fungsi NdkRequestCompletion yang ditentukan dalam parameter RequestCompletion untuk menyelesaikan permintaan secara asinkron.
STATUS_CONNECTION_INVALID	Permintaan gagal karena pasangan antrean tidak tersambung. Penting: Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
STATUS_CONNECTION_ABORTED	Serekan yang menerima meninggalkan pembentukan koneksi yang tertunda.
STATUS_IO_TIMEOUT	Permintaan gagal karena waktu pembentukan koneksi habis. Ini bukan indikasi bencana atau kegagalan permanen, tetapi mengakhiri pembentukan koneksi untuk konektor ini. Penting: Permintaan dapat gagal sebaris serta secara asinkron dengan kode status ini.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Fungsi NdkCompleteConnectEx menyelesaikan permintaan koneksi yang dimulai oleh panggilan sebelumnya ke fungsi NdkConnect (NDK_FN_CONNECT). Konsumen NDK memanggil NdkCompleteConnectEx setelah peer menerima permintaan koneksi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDKPI 2.1 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2022
Target Platform	Windows
Header	ndkpi.h (termasuk Ndkpi.h)
IRQL	<=DISPATCH_LEVEL