Funzione WSCUnInstallNameSpace32 (ws2spi.h)
La funzione WSCUnInstallNameSpace32 disinstalla un provider di spazi dei nomi a 32 bit specifico.
Sintassi
INT WSCUnInstallNameSpace32(
[in] LPGUID lpProviderId
);
Parametri
[in] lpProviderId
Puntatore a un identificatore univoco globale (GUID) per il provider dello spazio dei nomi da disinstallare.
Valore restituito
Se non si verifica alcun errore, WSCUnInstallNameSpace32 restituisce NO_ERROR (zero). In caso contrario, restituisce SOCKET_ERROR se la funzione ha esito negativo ed è necessario recuperare il codice di errore appropriato usando la funzione WSAGetLastError .
| Codice di errore | Significato |
|---|---|
| Il parametro lpProviderId punta alla memoria che non si trova in una parte valida dello spazio indirizzi utente. | |
| L'identificatore del provider dello spazio dei nomi specificato non è valido. | |
| Chiamata di sistema che non dovrebbe mai avere esito negativo. | |
| Memoria insufficiente disponibile. Questo errore viene restituito quando la memoria non è sufficiente per allocare una nuova voce del catalogo. |
Commenti
WSCUnInstallNameSpace32 è una versione a 32 bit di WSCUnInstallNameSpace. In un computer a 64 bit tutte le chiamate non sono specifiche a 32 bit (ad esempio, tutte le funzioni che non terminano in "32") operano sul catalogo nativo a 64 bit. I processi eseguiti in un computer a 64 bit devono usare le chiamate di funzione a 32 bit specifiche per operare su un catalogo a 32 bit e mantenere la compatibilità. Le definizioni e la semantica delle chiamate a 32 bit specifiche sono le stesse delle rispettive controparti native.
Le funzioni di configurazione dello spazio dei nomi non influiscono sulle applicazioni già in esecuzione. I provider di spazio dei nomi appena installati non saranno visibili alle applicazioni né le modifiche apportate allo stato di attivazione di un provider dello spazio dei nomi. Le applicazioni avviate dopo la chiamata a WSCUnInstallNameSpace32 riconosceranno le modifiche.
In caso di esito positivo, WSCUnInstallNameSpace32 tenterà di avvisare tutte le applicazioni interessate registrate per la notifica della modifica chiamando WSAProviderConfigChange.
La funzione WSCUnInstallNameSpace32 può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se WSCUnInstallNameSpace32 viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo e WSANO_RECOVERY viene restituito nel parametro lpErrno .
Per i computer in esecuzione in Windows Vista o Windows Server 2008, questa funzione può avere esito negativo anche a causa del controllo dell'account utente. Se un'applicazione che contiene questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel impostato su requireAdministrator. Se l'applicazione in Windows Vista o Windows Server 2008 non dispone di questo file manifesto, un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) affinché questa funzione abbia esito positivo.
Il chiamante di questa funzione deve rimuovere eventuali file aggiuntivi o informazioni di configurazione specifiche del provider di servizi necessarie per disinstallare completamente il provider di servizi.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP Professional x64 Edition [solo app desktop] |
| Server minimo supportato | Windows Server 2008, Windows Server 2003 x64 Edition [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2spi.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |