LPNSPV2CLIENTSESSIONRUNDOWN funzione di callback (ws2spi.h)
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 |
|---|---|
| Non è disponibile memoria sufficiente per eseguire questa operazione. | |
| La routine chiamante non dispone di privilegi sufficienti per installare il servizio. | |
| Uno o più parametri non sono validi o mancanti per questo provider. | |
| 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. | |
| 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 |