Compartilhar via


Função WSCUnInstallNameSpace32 (ws2spi.h)

A função WSCUnInstallNameSpace32 desinstala um provedor de namespace específico de 32 bits.

Nota Essa chamada é uma versão estritamente de 32 bits do WSCUnInstallNameSpace para uso em plataformas de 64 bits. Ele é fornecido para permitir que processos de 64 bits acessem os catálogos de 32 bits.

 

Sintaxe

INT WSCUnInstallNameSpace32(
  [in] LPGUID lpProviderId
);

Parâmetros

[in] lpProviderId

Um ponteiro para um GUID (identificador global exclusivo) para o provedor de espaço de nome a ser desinstalado.

Valor retornado

Se nenhum erro ocorrer, WSCUnInstallNameSpace32 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
WSAEFAULT
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.
WSAEINVAL
O identificador de namespace–provedor especificado é inválido.
WSASYSCALLFAILURE
Falha em uma chamada do sistema que nunca deve falhar.
WSA_NOT_ENOUGH_MEMORY
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

WSCUnInstallNameSpace32 é uma versão estritamente de 32 bits do WSCUnInstallNameSpace. Em um computador de 64 bits, todas as chamadas não são especificamente de 32 bits (por exemplo, todas as funções que não terminam em "32") operam no catálogo nativo de 64 bits. Os processos executados em um computador de 64 bits devem usar as chamadas de função específicas de 32 bits para operar em um catálogo estritamente de 32 bits e preservar a compatibilidade. As definições e a semântica das chamadas específicas de 32 bits são as mesmas que suas contrapartes nativas.

As funções de configuração de namespace não afetam os aplicativos que já estão em execução. Os provedores de name-space recém-instalados não estarã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 WSCUnInstallNameSpace32 reconhecerão as alterações.

Em caso de êxito, o WSCUnInstallNameSpace32 tentará alertar todos os aplicativos interessados que se registraram para notificação da alteração chamando WSAProviderConfigChange.

A função WSCUnInstallNameSpace32 só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se WSCUnInstallNameSpace32 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 um 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 como requireAdministrator. 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 aprimorado como administrador interno (administrador RunAs) para que essa função tenha êxito.

O chamador dessa função deve remover quaisquer 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

   
Cliente mínimo com suporte Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 x64 Edition [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2spi.h
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

WSAProviderConfigChange

WSCDeinstallProvider32

WSCEnumProtocols32

WSCInstallNameSpace32

WSCUnInstallNameSpace