Função WSCEnableNSProvider (ws2spi.h)

  • Artigo

A função WSCEnableNSProvider altera o estado de um determinado provedor de namespace. Ele destina-se a dar ao usuário final a capacidade de alterar o estado dos provedores de namespace.

Sintaxe

INT WSCEnableNSProvider(
  [in] LPGUID lpProviderId,
  [in] BOOL   fEnable
);

Parâmetros

[in] lpProviderId

Um ponteiro para um GUID (identificador global exclusivo) para o provedor de namespace.

[in] fEnable

Um valor booliano que, se TRUE, o provedor é definido como o estado ativo. Se FALSE, o provedor será desabilitado e não estará disponível para operações de consulta ou registro de serviço.

Retornar valor

Se nenhum erro ocorrer, a função WSCEnableNSProvider 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 do provedor de namespace especificado é inválido.
WSASYSCALLFAILURE
 Uma chamada do sistema que nunca deve falhar falhou.
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

A função WSCEnableNSProvider destina-se a ser usada para alterar o estado dos provedores de namespace. Um ISV (fornecedor de software independente) normalmente não deve desativar outro provedor de namespace ISV para ativar seu próprio. A escolha deve ser deixada para o usuário.

A função WSCEnableNSProvider não afeta aplicativos que já estão em execução. Os provedores de namespace recém-instalados não ficarão visíveis para aplicativos nem as alterações no estado de ativação de um provedor de namespace ficarão visíveis. Os aplicativos iniciados após a chamada para WSCEnableNSProvider verão as alterações.

A função WSCEnableNSProvider só pode ser chamada por um usuário conectado como membro do grupo Administradores. Se WSCEnableNSProvider for chamado por um usuário que não é membro do grupo Administradores, a chamada de função falhará.

Para computadores que executam o Windows Vista ou o 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.

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

Confira também

WSCEnumProtocols

WSCInstallNameSpace

WSCUnInstallNameSpace

WSCWriteNameSpaceOrder