Função WSAGetServiceClassNameByClassIdA (winsock2.h)

Artigo
11/20/2024

A função WSAGetServiceClassNameByClassId recupera o nome do serviço associado ao tipo especificado. Esse nome é o nome do serviço genérico, como FTP ou SNA, e não o nome de uma instância específica desse serviço.

Sintaxe

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Parâmetros

[in] lpServiceClassId

Um ponteiro para o GUID para a classe de serviço.

[out] lpszServiceClassName

Um ponteiro para o nome do serviço.

[in, out] lpdwBufferLength

Na entrada, o comprimento do buffer retornado por lpszServiceClassName, em caracteres. Na saída, o comprimento do nome do serviço copiado para lpszServiceClassName, em caracteres.

Valor de retorno

A função WSAGetServiceClassNameByClassId retorna um valor zero se 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 parâmetro lpServiceClassId especificado é inválido.
WSA_NOT_ENOUGH_MEMORY	Não havia memória suficiente para executar a operação.
WSAEACCES	A rotina de chamada não tem privilégios suficientes para acessar as informações.
WSAEFAULT	O buffer especificado apontado por lpszServiceClassName é muito pequeno. Passe um buffer maior.
WSAENOBUFS	Nenhum espaço em buffer disponível.
WSAEOPNOTSUPP	Não há suporte para a operação para o tipo de objeto referenciado. Esse erro é retornado por alguns provedores de namespace que não dão suporte à obtenção de informações de classe de serviço.
WSANO_DATA	O lpServiceClassId é 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 WSAGetServiceClassNameByClassId 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 [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	winsock2.h
biblioteca	Ws2_32.lib
de DLL	Ws2_32.dll

Consulte também

WSAStartup

do Winsock Functions

referência Winsock

Compartilhar via