LPNSPV2LOOKUPSERVICEEND fungsi panggilan balik (ws2spi.h)

Artikel
08/28/2023

Fungsi NSPv2LookupServiceEnd dipanggil untuk membebaskan handel setelah panggilan sebelumnya ke NSPv2LookupServiceBegin dan NSPv2LookupServiceNextEx.

Sintaks

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

Parameter

[in] hLookup

Handel yang diperoleh sebelumnya dengan panggilan ke
NSPv2LookupServiceBegin.

Mengembalikan nilai

Fungsi harus mengembalikan NO_ERROR (nol) jika rutinitas berhasil. Ini harus mengembalikan SOCKET_ERROR (yaitu, 1) jika rutinitas gagal dan harus mengatur kode kesalahan yang sesuai menggunakan WSASetLastError.

Kode kesalahan	Makna
WSA_INVALID_HANDLE	Handel tidak valid.
WSA_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori untuk melakukan operasi ini.

Keterangan

Fungsi NSPv2LookupServiceEnd digunakan sebagai bagian dari arsitektur penyedia layanan namespace versi-2 (NSPv2) yang tersedia di Windows Vista dan yang lebih baru.

Pada Windows Vista dan Windows Server 2008, fungsi NSPv2LookupServiceEnd hanya dapat digunakan untuk operasi pada penyedia namespace layanan NS_EMAIL.

Dimungkinkan untuk menerima panggilan fungsi NSPv2LookupServiceBegin pada utas lain saat memproses NSPv2LookupServiceNextEx. Ini menunjukkan bahwa klien telah membatalkan permintaan dan penyedia harus menutup handel dan pengembalian dari panggilan fungsi NSPv2LookupServiceNextEx juga, mengatur kesalahan terakhir ke WSA_E_CANCELLED.

Di Windows Sockets 2, kode kesalahan yang bertentangan didefinisikan untuk WSAECANCELLED dan WSA_E_CANCELLED. Kode kesalahan WSAECANCELLED akan dihapus dalam versi mendatang dan hanya WSA_E_CANCELLED yang akan tetap ada. Penyedia Namespace harus menggunakan kode kesalahan WSA_E_CANCELLED untuk mempertahankan kompatibilitas dengan berbagai aplikasi seluas mungkin.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	ws2spi.h