Bagikan melalui

Fungsi panggilan balik LPNSPCLEANUP (ws2spi.h)

  • Artikel

Fungsi NSPCleanup mengakhiri penggunaan penyedia layanan namespace Layanan Windows Sockets tertentu.

Sintaks

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Parameter

[in] lpProviderId

Pointer ke GUID penyedia namespace layanan yang akan dihentikan.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, maka NSPCleanup mengembalikan nilai NO_ERROR (nol). Jika tidak, SOCKET_ERROR (–1) dikembalikan, dan penyedia harus mengatur kode kesalahan yang sesuai menggunakan WSASetLastError.

Kode kesalahan Makna
WSA_NOT_ENOUGH_MEMORY Tidak tersedia cukup memori untuk melakukan operasi ini.
WSAEINVAL Parameter lpProviderId tidak menentukan penyedia yang valid.
WSAEOPNOTSUPP Operasi tidak didukung. Kesalahan ini dikembalikan jika penyedia namespace tidak menerapkan fungsi ini.

Keterangan

Fungsi NSPCleanup dipanggil ketika aplikasi selesai menggunakan penyedia layanan namespace Layanan Windows Sockets. Fungsi NSPCleanup membatalkan pendaftaran penyedia namespace layanan tertentu dan memungkinkan penyedia layanan transportasi membebaskan salah satu sumber daya penyedia namespace layanan yang dialokasikan.

Fungsi NSPStartup harus berhasil dipanggil sebelum menggunakan penyedia namespace layanan apa pun. Diperbolehkan untuk melakukan lebih dari satu panggilan NSPStartup . Namun, untuk setiap panggilan NSPStartup , panggilan NSPCleanup yang sesuai juga harus dikeluarkan. Hanya NSPCleanup akhir untuk penyedia layanan yang melakukan pembersihan aktual; panggilan sebelumnya mengurangi jumlah referensi internal di penyedia layanan.

Fungsi ini tidak boleh kembali sampai DLL penyedia layanan namespace dapat dibongkar dari memori.

Persyaratan

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

Lihat juga