Condividi tramite

Funzione di callback LPNSPCLEANUP (ws2spi.h)

  • Articolo

La funzione NSPCleanup termina l'uso di un provider di servizi dello spazio dei nomi Windows Sockets specifico.

Sintassi

LPNSPCLEANUP Lpnspcleanup;

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

Parametri

[in] lpProviderId

Puntatore al GUID del provider dello spazio dei nomi da terminare.

Valore restituito

Se non si verifica alcun errore, NSPCleanup restituisce un valore pari a NO_ERROR (zero). In caso contrario, viene restituito SOCKET_ERROR (-1) e il provider deve impostare il codice di errore appropriato usando WSASetLastError.

Codice di errore Significato
WSA_NOT_ENOUGH_MEMORY Memoria insufficiente per eseguire questa operazione.
WSAEINVAL Il parametro lpProviderId non specifica un provider valido.
WSAEOPNOTSUPP L'operazione non è supportata. Questo errore viene restituito se il provider dello spazio dei nomi non implementa questa funzione.

Commenti

La funzione NSPCleanup viene chiamata quando un'applicazione viene completata usando un provider di servizi dello spazio dei nomi Windows Sockets. La funzione NSPCleanup annulla la registrazione di un provider di spazi dei nomi specifico e consente al provider di servizi di trasporto di liberare le risorse allocate del provider dello spazio dei nomi.

La funzione NSPStartup deve essere chiamata correttamente prima di usare qualsiasi provider di spazi dei nomi. È consentito effettuare più chiamate NSPStartup . Tuttavia, per ogni chiamata NSPStartup , deve essere eseguita anche una chiamata NSPCleanup corrispondente. Solo l'NSPCleanup finale per il provider di servizi esegue la pulizia effettiva; le chiamate precedenti decrementa un conteggio dei riferimenti interni nel provider di servizi.

Questa funzione non deve restituire finché la DLL del provider di servizi dello spazio dei nomi non può essere scaricata dalla memoria.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ws2spi.h

Vedi anche