Função GetNameByTypeA (nspapi.h)

Artigo
11/20/2024

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

Observação A função GetNameByType é 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, o material de referência é o seguinte.

Observação As funções detalhadas em Protocol-Independent Resolução de Nomes 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 com término 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.

Valor de retorno

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.

Observações

Nota

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

GetTypeByName

do Winsock Functions

referência Winsock

Compartilhar via