Função WSAInstallServiceClassA (winsock2.h)

  • Artigo

A função WSAInstallServiceClass registra um esquema de classe de serviço em um namespace. Esse esquema inclui o nome da classe, o identificador de classe e todas as informações específicas do namespace que são comuns a todas as instâncias do serviço, como o identificador sap ou o identificador de objeto.

Sintaxe

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Parâmetros

[in] lpServiceClassInfo

Classe de serviço para informações de mapeamento específicas do namespace. Vários mapeamentos podem ser tratados ao mesmo tempo.

Consulte a seção Estruturas de Dados da Classe de Serviço para obter uma descrição das estruturas de dados pertinentes.

Valor retornado

O valor retornado será zero se a operação tiver sido bem-sucedida. Caso contrário, o valor SOCKET_ERROR será retornado e um número de erro específico poderá ser recuperado chamando WSAGetLastError.

Código do erro Significado
WSA_INVALID_PARAMETER
 O provedor de namespace não pode fornecer as informações de classe solicitadas.
WSA_NOT_ENOUGH_MEMORY
 Não havia memória suficiente para executar a operação.
WSAEACCES
 A função de chamada não tem privilégios suficientes para instalar o serviço.
WSAEALREADY
 As informações da classe de serviço já foram registradas para esse identificador de classe de serviço. Para modificar as informações da classe de serviço, primeiro use WSARemoveServiceClass e reinstale com dados de informações de classe atualizados.
WSAEINVAL
 As informações da classe de serviço não eram válidas ou estruturadas incorretamente. Esse erro será retornado se o parâmetro lpServiceClassInfo for NULL.
WSAEOPNOTSUPP
 A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função.
WSANO_DATA
 O nome solicitado é válido, mas nenhum dado do tipo solicitado foi encontrado.
WSANOTINITIALISED
 O WS2_32.DLL não foi inicializado. O aplicativo deve primeiro chamar WSAStartup antes de chamar qualquer função do Windows Sockets.

Comentários

Observação

O cabeçalho winsock2.h define WSAInstallServiceClass como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
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 winsock2.h
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

Wsagetlasterror

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Funções Winsock

Referência de Winsock