Funzione WSCUnInstallNameSpace (ws2spi.h)
La funzione WSCUnInstallNameSpace disinstalla il provider di spazio dei nomi indicato.
Sintassi
INT WSCUnInstallNameSpace(
[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, WSCUnInstallNameSpace restituisce NO_ERROR (zero). In caso contrario, restituisce SOCKET_ERROR se la funzione ha esito negativo e è 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 degli indirizzi utente. | |
| L'identificatore del provider di spazio dei nomi specificato non è valido. | |
| Una chiamata di sistema che non deve mai avere esito negativo. | |
| Memoria insufficiente disponibile. Questo errore viene restituito quando è presente memoria insufficiente per allocare una nuova voce del catalogo. |
Commenti
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 di spazio dei nomi. Le applicazioni avviate dopo la chiamata a WSCUnInstallNameSpace visualizzeranno le modifiche.
In caso di esito positivo, WSCUnInstallNameSpace tenterà di avvisare tutte le applicazioni interessate registrate per la notifica della modifica chiamando WSAProviderConfigChange.
La funzione WSCUnInstallNameSpace può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se WSCUnInstallNameSpace viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata alla funzione avrà esito negativo e WSANO_RECOVERY viene restituita nel parametro lpErrno .
Per i computer in esecuzione in Windows Vista o Windows Server 2008, questa funzione può anche non riuscire a causa del controllo account utente (UAC). Se un'applicazione contenente 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 per richiedereAdministrator. Se l'applicazione in Windows Vista o Windows Server 2008 manca questo file manifesto, un utente ha eseguito l'accesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) per questa funzione.
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
| 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 |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |