Share via

Função GetNameByTypeA (nspapi.h)

  • Artigo

A função GetNameByType recupera o nome de um serviço de rede para o tipo de serviço especificado.

Nota A função GetNameByType é 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, o material de referência é o seguinte.
 
Nota As funções detalhadas na Resolução de Nomes Independentes de Protocolo fornecem funcionalidade equivalente no Windows Sockets 2.
 

Sintaxe

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Parâmetros

[in] lpServiceType

Um ponteiro para 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 .

[out] lpServiceName

Um ponteiro para um buffer para receber uma cadeia de caracteres terminada em zero que representa exclusivamente o nome do serviço de rede.

[in] dwNameLength

Um ponteiro para uma variável que, na entrada, especifica o tamanho, em bytes, do buffer apontado por lpServiceName. Na saída, a variável contém o tamanho real da cadeia de caracteres de nome de serviço, em bytes.

Retornar valor

Se a função for bem-sucedida, o valor retornado não será SOCKET_ERROR (–1).

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

Comentários

Observação

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

GetTypeByName

Funções Winsock

Referência de Winsock