Função GetTypeByNameA (nspapi.h)

Artigo
11/20/2024

A função GetTypeByName recupera um tipo de serviço guid para um serviço de rede especificado pelo nome.

Observação a função GetTypeByName é uma extensão específica da Microsoft para a especificação do Windows Sockets 1.1. Essa função é obsoleta. Para a conveniência dos desenvolvedores do Windows Sockets 1.1, esse material de referência está incluído. As funções detalhadas no Protocol-Independent Name Resolution fornecem funcionalidade equivalente no Windows Sockets 2.

Sintaxe

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

Parâmetros

[in] lpServiceName

Um ponteiro para uma cadeia de caracteres com término zero que representa exclusivamente o nome do serviço. Por exemplo, "MY SNA SERVER".

[in, out] lpServiceType

Um ponteiro para uma variável para receber um identificador global exclusivo (GUID) que especifica o tipo do serviço de rede. O arquivo de cabeçalho Svcguid.h inclui definições de várias GUID tipos de serviço e macros para trabalhar com eles.

O arquivo de cabeçalho Svcguid.h não é incluído automaticamente pelo arquivo de cabeçalho Winsock2.h.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será zero.

Se a função falhar, o valor retornado será SOCKET_ERROR( – 1). Para obter informações de erro estendidas, chame GetLastError, que retorna o seguinte valor de erro estendido.

Valor	Significado
ERROR_SERVICE_DOES_NOT_EXIST	O tipo de serviço especificado é desconhecido.

Observações

Nota

O cabeçalho nspapi.h define GetTypeByName 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

GetNameByType

do Winsock Functions

referência Winsock

Compartilhar via