Funzione WSCDeinstallProvider (ws2spi.h)
La funzione WSCDeinstallProvider rimuove il provider di trasporto specificato dal database di configurazione del sistema.
Sintassi
int WSCDeinstallProvider(
[in] LPGUID lpProviderId,
[out] LPINT lpErrno
);
Parametri
[in] lpProviderId
Puntatore a un identificatore univoco globale (GUID) per il provider. Questo valore viene archiviato all'interno di ogni struttura WSAProtocol_Info .
[out] lpErrno
Puntatore al codice di errore se la funzione ha esito negativo.
Valore restituito
Se non si verifica alcun errore, WSCDeinstallProvider restituisce zero. In caso contrario, restituisce SOCKET_ERROR e un codice di errore specifico è disponibile in lpErrno.
| Codice di errore | Significato |
|---|---|
| Il parametro lpProviderId non specifica un provider valido. | |
| Il parametro lpErrno non si trova in una parte valida dello spazio indirizzi utente. | |
| Si è verificato un errore irreversibile. Questo errore viene restituito in diverse condizioni, tra cui: l'utente non dispone dei privilegi amministrativi necessari per scrivere nel Registro di sistema Windows Sockets o si è verificato un errore durante l'apertura di una voce del catalogo. | |
| Memoria insufficiente disponibile. Questo errore viene restituito quando la memoria non è sufficiente per allocare una nuova voce del catalogo. |
Commenti
La funzione WSCDeinstallProvider rimuove le informazioni di configurazione comuni di Windows Sockets 2 per il provider specificato. Al termine di questa routine, le informazioni di configurazione archiviate nel Registro di sistema verranno modificate. Tuttavia, tutte le istanze di Ws2_32.dll attualmente in memoria non saranno in grado di riconoscere questa modifica.
In caso di esito positivo, WSCDeinstallProvider tenterà di avvisare tutte le applicazioni interessate registrate per la notifica della modifica chiamando WSAProviderConfigChange.
La funzione WSCDeinstallProvider può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se WSCDeinstallProvider 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 che eseguono 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
| 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 |