Função WSAInstallServiceClassA (winsock2.h)

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 qualquer informação específica do namespace que seja comum 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 de retorno

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 de 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 estiver NULL.
WSAEOPNOTSUPP	Não há suporte para a operação. 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 as funções do Windows Sockets.

Observações

Nota

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

Consulte também

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

do Winsock Functions

referência Winsock