Função GetTypeByNameA (nspapi.h)

  • Artigo

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

Nota A função GetTypeByName é uma extensão específica da Microsoft para a especificação do Windows Sockets 1.1. Essa função está obsoleta. Para a conveniência dos desenvolvedores do Windows Sockets 1.1, esse material de referência está incluído. As funções detalhadas na Resolução de Nomes Independentes de Protocolo 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 terminada em 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 GUID (identificador global exclusivo) que especifica o tipo do serviço de rede. O arquivo de cabeçalho Svcguid.h inclui definições de vários tipos de serviço GUID 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 .

Retornar valor

Se a função obtiver êxito, 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.

Comentários

Observação

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 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

Requisito Valor
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 nspapi.h
Biblioteca Mswsock.lib
DLL Mswsock.dll

Confira também

GetNameByType

Funções Winsock

Referência de Winsock