LPNSPV2CLIENTSESSIONRUNDOWN fungsi panggilan balik (ws2spi.h)

Artikel
08/28/2023

Fungsi NSPv2ClientSessionRundown memberi tahu penyedia layanan namespace layanan versi-2 (NSPv2) bahwa sesi klien dihentikan.

Sintaks

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

void Lpnspv2clientsessionrundown(
  [in] LPGUID lpProviderId,
  [in] LPVOID pvClientSessionArg
)
{...}

Parameter

[in] lpProviderId

Penunjuk ke GUID penyedia namespace layanan tertentu untuk memberi tahu.

[in] pvClientSessionArg

Penunjuk ke sesi klien yang dihentikan.

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_NOT_ENOUGH_MEMORY	Tidak tersedia cukup memori untuk melakukan operasi ini.
WSAEACCES	Rutinitas panggilan tidak memiliki hak istimewa yang memadai untuk menginstal layanan.
WSAEINVAL	Satu atau beberapa parameter tidak valid, atau hilang, untuk penyedia ini.
WSAEOPNOTSUPP	Operasi ini tidak didukung. Kesalahan ini dikembalikan jika penyedia namespace tidak mengimplementasikan fungsi ini. Kesalahan ini juga dapat dikembalikan jika dwControlCode yang ditentukan adalah perintah yang tidak dikenali.
WSASERVICE_NOT_FOUND	Layanan tidak diketahui. Layanan tidak dapat ditemukan di namespace yang ditentukan.

Keterangan

Fungsi NSPv2ClientSessionRundown 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 NSPv2ClientSessionRundown hanya dapat digunakan untuk operasi pada penyedia namespace NS_EMAIL.

Fungsi NSPv2Startup dipanggil setiap kali proses klien baru dimulai menggunakan penyedia namespace layanan. Penyedia dapat menggunakan argumen sesi klien yang diarahkan oleh parameter ppvClientSessionArg untuk menyimpan informasi tentang sesi ini. Jika nilai ditentukan untuk argumen sesi klien dalam panggilan ke fungsi NSPv2Startup , argumen sesi klien yang sama ini diteruskan dalam parameter pvClientSessionArg ke fungsi NSPv2ClientSessionRundown .

Fungsi NSPv2Startup, NSPv2ClientSessionRundown, dan NSPv2Cleanup bersifat opsional, tergantung pada persyaratan penyedia NSPv2.

Jika fungsi NSPv2ClientSessionRundown tidak diimplementasikan, maka panggilan ke fungsi tersebut harus disadap oleh fungsi stub yang mengembalikan WSAEOPNOTSUPP. Penunjuk fungsi NSPv2 ke fungsi NSPv2ClientSessionRundown yang tidak tertandingi dalam struktur NSPV2_ROUTINE harus menunjuk ke fungsi stub.

Persyaratan


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