Função WSCUnInstallNameSpace (ws2spi.h)
A função WSCUnInstallNameSpace desinstala o provedor de espaço de nome indicado.
Sintaxe
INT WSCUnInstallNameSpace(
[in] LPGUID lpProviderId
);
Parâmetros
[in] lpProviderId
Um ponteiro para um GUID (identificador global exclusivo) para que o provedor de espaço de nome seja desinstalado.
Retornar valor
Se nenhum erro ocorrer, WSCUnInstallNameSpace retornará NO_ERROR (zero). Caso contrário, ele retornará SOCKET_ERROR se a função falhar e você deverá recuperar o código de erro apropriado usando a função WSAGetLastError .
| Código do erro | Significado |
|---|---|
| O parâmetro lpProviderId aponta para a memória que não está em uma parte válida do espaço de endereço do usuário. | |
| O identificador namespace–provider especificado é inválido. | |
| Uma chamada do sistema que nunca deve falhar falhou. | |
| Memória insuficiente disponível. Esse erro é retornado quando não há memória suficiente para alocar uma nova entrada de catálogo. |
Comentários
As funções de configuração de namespace não afetam os aplicativos que já estão em execução. Os provedores de espaço de nome recém-instalados não ficarão visíveis para aplicativos nem as alterações no estado de ativação de um provedor de espaço de nome. Os aplicativos iniciados após a chamada para WSCUnInstallNameSpace verão as alterações.
Com êxito, o WSCUnInstallNameSpace tentará alertar todos os aplicativos interessados que se registraram para notificação da alteração chamando WSAProviderConfigChange.
A função WSCUnInstallNameSpace só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se WSCUnInstallNameSpace for chamado por um usuário que não é membro do grupo Administradores, a chamada de função falhará e WSANO_RECOVERY será retornado no parâmetro lpErrno .
Para computadores em execução no Windows Vista ou no Windows Server 2008, essa função também pode falhar devido ao UAC (controle de conta de usuário). Se um aplicativo que contém essa função for executado por um usuário conectado como membro do grupo Administradores diferente do Administrador interno, essa chamada falhará, a menos que o aplicativo tenha sido marcado no arquivo de manifesto com um requestedExecutionLevel definido para exigirAdministrator. Se o aplicativo no Windows Vista ou no Windows Server 2008 não tiver esse arquivo de manifesto, um usuário conectado como membro do grupo Administradores que não seja o Administrador interno deverá executar o aplicativo em um shell avançado como administrador interno (administrador de RunAs) para que essa função tenha êxito.
O chamador dessa função deve remover arquivos adicionais ou informações de configuração específicas do provedor de serviços necessárias para desinstalar completamente o provedor de serviços.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ws2spi.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |