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 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 |
|---|---|
| O provedor de namespace não pode fornecer as informações de classe solicitadas. | |
| Não havia memória suficiente para executar a operação. | |
| A função de chamada não tem privilégios suficientes para instalar o serviço. | |
| 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. | |
| 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. | |
| A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função. | |
| O nome solicitado é válido, mas nenhum dado do tipo solicitado foi encontrado. | |
| 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 |