NDK_FN_COMPLETE_CONNECT fungsi panggilan balik (ndkpi.h)

Artikel
03/08/2023

Fungsi NdkCompleteConnect (NDK_FN_COMPLETE_CONNECT) menyelesaikan permintaan koneksi asinkron.

Sintaks

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

Parameter

[in] pNdkConnector

Penunjuk ke objek konektor NDK (NDK_CONNECTOR).

[in, optional] DisconnectEvent

Panggilan balik pemberitahuan pemutusan opsional fungsi NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK) yang dipanggil penyedia saat 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 yang 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 NdkCompleteConnect menyelesaikan permintaan koneksi yang dimulai oleh panggilan sebelumnya ke fungsi NdkConnect (NDK_FN_CONNECT). Konsumen NDK memanggil NdkCompleteConnect setelah peer menerima permintaan koneksi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung, Didukung di NDIS 6.30 dan yang lebih baru.
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	ndkpi.h (termasuk Ndkpi.h)
IRQL	<=DISPATCH_LEVEL