Compartilhar via

Função SetServiceW (nspapi.h)

  • Artigo

A função SetService registra ou remove do registro um serviço de rede em um ou mais namespaces. A função também pode adicionar ou remover um tipo de serviço de rede em um ou mais namespaces.

Observação A função SetService está obsoleta. As funções detalhadas no Protocol-Independent Name Resolution fornecem funcionalidade equivalente no Windows Sockets 2. Para a conveniência dos desenvolvedores do Windows Sockets 1.1, o material de referência é o seguinte.
 

Sintaxe

INT SetServiceW(
  [in]           DWORD                dwNameSpace,
  [in]           DWORD                dwOperation,
  [in]           DWORD                dwFlags,
  [in]           LPSERVICE_INFOW      lpServiceInfo,
  [in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo,
  [out]          LPDWORD              lpdwStatusFlags
);

Parâmetros

[in] dwNameSpace

O namespace ou um conjunto de namespaces padrão, no qual a função funcionará.

Use uma das seguintes constantes para especificar um namespace.

Valor Significado
NS_DEFAULT
 Um conjunto de namespaces padrão. A função consulta cada namespace dentro desse conjunto. O conjunto de namespaces padrão normalmente inclui todos os namespaces instalados no sistema. No entanto, os administradores do sistema podem excluir namespaces específicos do conjunto. NS_DEFAULT é o valor que a maioria dos aplicativos deve usar para dwNameSpace.
NS_DNS
 O Sistema de Nomes de Domínio usado na Internet para resolver o nome do host.
NS_NDS
 O provedor NetWare 4.
NS_NETBT
 O NetBIOS sobre a camada TCP/IP. Todos os sistemas Windows registram seus nomes de computador com NetBIOS. Esse namespace é usado para converter um nome de computador em um endereço IP que usa esse registro.
NS_SAP
 O Protocolo de Publicidade do Serviço NetWare. Isso pode acessar a associação NetWare, se apropriado. NS_SAP é um namespace dinâmico que permite o registro de serviços.
NS_TCPIP_HOSTS
 Valor de pesquisa no arquivo <systemroot>\system32\drivers\etc\posts.
NS_TCPIP_LOCAL
 Mecanismos de resolução de nomes TCP/IP locais, incluindo comparações com o nome do host local e o valor de pesquisa no cache do host para mapeamentos de endereço IP.

[in] dwOperation

A operação que a função executará. Use um dos seguintes valores para especificar uma operação:

Valor Significado
SERVICE_REGISTER
 Registre o serviço de rede com o namespace. Essa operação pode ser usada com os sinalizadores de bits SERVICE_FLAG_DEFER e SERVICE_FLAG_HARD.
SERVICE_DEREGISTER
 Remova do registro o serviço de rede do namespace. Essa operação pode ser usada com os sinalizadores de bits SERVICE_FLAG_DEFER e SERVICE_FLAG_HARD.
SERVICE_FLUSH
 Execute qualquer operação que tenha sido chamada com o sinalizador de bits SERVICE_FLAG_DEFER definido como um.
SERVICE_ADD_TYPE
 Adicione um tipo de serviço ao namespace.

Para esta operação, use o ServiceSpecificInfo membro da estrutura SERVICE_INFO apontada por lpServiceInfo para passar uma estrutura de SERVICE_TYPE_INFO_ABS. Você também deve definir o membro ServiceType da estrutura de SERVICE_INFO. Outros membros SERVICE_INFO são ignorados.
SERVICE_DELETE_TYPE
 Remova um tipo de serviço, adicionado por uma chamada anterior especificando a operação SERVICE_ADD_TYPE, do namespace.

[in] dwFlags

Um conjunto de sinalizadores de bits que modificam a operação da função. Você pode definir um ou mais dos seguintes sinalizadores de bits:

Valor Significado
SERVICE_FLAG_DEFER
 Esse sinalizador de bit só será válido se a operação for SERVICE_REGISTER ou SERVICE_DEREGISTER.

Se esse sinalizador de bits for um e for válido, o provedor de namespace deverá adiar a operação de registro ou desregistração até que uma operação de SERVICE_FLUSH seja solicitada.
SERVICE_FLAG_HARD
 Esse sinalizador de bit só será válido se a operação for SERVICE_REGISTER ou SERVICE_DEREGISTER.

Se esse sinalizador de bits for um e for válido, o provedor de namespace atualizará as informações relevantes do repositório persistente quando a operação for executada.

Por exemplo: se a operação envolver o cancelamento do registro em um namespace que usa um repositório persistente, o provedor de namespace removerá as informações relevantes do repositório persistente.

[in] lpServiceInfo

Um ponteiro para uma estrutura de SERVICE_INFO que contém informações sobre o serviço de rede ou o tipo de serviço.

[in, optional] lpServiceAsyncInfo

Reservado para uso futuro. Deve ser definido como NULL.

[out] lpdwStatusFlags

Um conjunto de sinalizadores de bits que recebem informações de status da função. O seguinte sinalizador de bits é definido:

Valor Significado
SET_SERVICE_ PARTIAL_SUCCESS
 Um ou mais provedores de namespace não conseguiram executar a operação solicitada com êxito.

Valor de retorno

Se a função falhar, o valor retornado será SOCKET_ERROR. Para obter informações de erro estendidas, chame GetLastError. GetLastError pode retornar o seguinte valor de erro estendido.

Código de erro Significado
ERROR_ALREADY_ registrado
 A função tentou registrar um serviço que já estava registrado.

Observações

Nota

O cabeçalho nspapi.h define SetService como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho nspapi.h
biblioteca Mswsock.lib
de DLL Mswsock.dll

Consulte também

GetService

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

do Winsock Functions

referência Winsock