LPNSPV2CLIENTSESSIONRUNDOWN funzione di callback (ws2spi.h)

Articolo
08/28/2023

La funzione NSPv2ClientSessionRundown informa un provider di servizi dello spazio dei nomi versione-2 (NSPv2) che la sessione client termina.

Sintassi

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

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

Parametri

[in] lpProviderId

Puntatore al GUID del provider di spazi dei nomi specifico da notificare.

[in] pvClientSessionArg

Puntatore alla sessione client che termina.

Valore restituito

La funzione deve restituire NO_ERROR (zero) se la routine ha esito positivo. Deve restituire SOCKET_ERROR (ovvero 1) se la routine ha esito negativo e deve impostare il codice di errore appropriato usando WSASetLastError.

Codice di errore	Significato
WSA_NOT_ENOUGH_MEMORY	Non è disponibile memoria sufficiente per eseguire questa operazione.
WSAEACCES	La routine chiamante non dispone di privilegi sufficienti per installare il servizio.
WSAEINVAL	Uno o più parametri non sono validi o mancanti per questo provider.
WSAEOPNOTSUPP	L'operazione non è supportata. Questo errore viene restituito se il provider di spazi dei nomi non implementa questa funzione. Questo errore può essere restituito anche se il dwControlCode specificato è un comando non riconosciuto.
WSASERVICE_NOT_FOUND	Il servizio è sconosciuto. Impossibile trovare il servizio nello spazio dei nomi specificato.

Commenti

La funzione NSPv2ClientSessionRundown viene usata come parte dell'architettura del provider di servizi dello spazio dei nomi versione 2 (NSPv2) disponibile in Windows Vista e versioni successive.

In Windows Vista e Windows Server 2008 la funzione NSPv2ClientSessionRundown può essere usata solo per le operazioni sui provider di spazi dei nomi NS_EMAIL.

La funzione NSPv2Startup viene chiamata ogni volta che un nuovo processo client inizia usando il provider di spazi dei nomi. I provider possono usare l'argomento sessione client a cui punta il parametro ppvClientSessionArg per archiviare informazioni su questa sessione. Se viene specificato un valore per l'argomento sessione client nella chiamata alla funzione NSPv2Startup , lo stesso argomento sessione client viene passato al parametro pvClientSessionArg alla funzione NSPv2ClientSessionRundown .

Le funzioni NSPv2Startup, NSPv2ClientSessionRundown e NSPv2Cleanup sono facoltative, a seconda dei requisiti del provider NSPv2.

Se la funzione NSPv2ClientSessionRundown non viene implementata, le chiamate a tale funzione devono essere intercettate da una funzione stub che restituisce WSAEOPNOTSUPP. Il puntatore alla funzione NSPv2 alla funzione NSPv2ClientSessionRundown non implementata nella struttura NSPV2_ROUTINE deve puntare alla funzione stub.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ws2spi.h