getnameinfo

9/8/2008

Essa função fornece resolução de nomes de um endereço para o nome do host.

Syntax

int getnameinfo(
  const struct sockaddr FAR* sa,
  socklen_t salen,
  char FAR* host,
  DWORD hostlen,
  char FAR* serv,
  DWORD servlen,
  int flags
);

Parameters

• SA
  [no] Ponteiro para uma estrutura endereço de soquete que contém o número endereço e porta da Soquete. Para IPv4, o SA parâmetro aponta para um sockaddr_in estrutura; Para o IPv6, a SA parâmetro aponta para um sockaddr_in6 estrutura.

• salen
  [no] Comprimento da estrutura apontada para na SA parâmetro.

• hospedar
  [out] Ponteiro para o nome do host. O nome do host é retornado como um nome de domínio totalmente qualificado (FQDN, fully qualified domain name) Por padrão.

• hostlen
  [no] Comprimento da reserva apontado pelo hospedar parâmetro. O chamador deve fornecer uma reserva grande o suficiente para armazenar o nome do host, incluindo encerrando NULL caracteres. Um valor de zero indica o chamador não desejar receber o seqüência de caracteres fornecidas no hospedar.

• serv
  [out] Ponteiro para o nome serviço associado com número de porta.

• servlen
  [no] Comprimento da reserva apontado pelo serv parâmetro. O chamador deve fornecer uma reserva grande o suficiente para armazenar o nome serviço, incluindo encerrando NULL caracteres. Um valor de zero indica o chamador não desejar receber o seqüência de caracteres fornecidas no serv.

• Sinalizadores
  [no] Sinalizadores usados para personalizar processamento desta função.

Return Value

Se não houver erro, essa função retornará zero. Qualquer diferente de zero valor de retorno indica falha. Use a função WSAGetLastError para recuperar informações de erro.

Remarks

Para simplificar Determinando requisitos reserva para o hospedar e serv parâmetros, a seguinte valores para o comprimento máximo nome do host e nome máximo de serviço são definidos no arquivo de cabeçalho Ws2tcpip.h:

#define NI_MAXHOST  1025
#define NI_MAXSERV    32

O Sinalizadores parâmetro pode ser usado para personalizar processamento desta função. A seguinte tabela mostra a disponível sinalizadores.

Sinalizador	Descrição
NI_NOFQDN	Configurar os resultados sinalizador NI_NOFQDN no local hosts tendo apenas suas Relative Distinguished Name (RDN) retornados na hospedar parâmetro.
NI_NUMERICHOST	Definir esse sinalizador retorna a forma numérica da nome do host instead of seu nome. A forma numérica da nome do host também é retornada se a nome do host não puder ser resolvido pelo sistema de nome de domínio (DNS).
NI_NAMEREQD	Definir esse sinalizador é definido resultados em um erro quando hospedar nomes não podem ser resolvidos por sistema de nome de domínio (DNS) (sistema de nome de domínio (DNS)).
NI_NUMERICSERV	Definir esse sinalizador retorna o número porta do serviço instead of seu nome.
NI_DGRAM	Definir Esse sinalizador indica que o serviço é um serviço datagrama. Este sinalizador é necessária para os serviços alguns que fornecem diferentes porta números para serviço UDP e TCP.

Requirements

Header	ws2tcpip.h
Library	Ws2.lib
Windows Embedded CE	Windows CE .NET 4.1 and later
Windows Mobile	Windows Mobile Version 5.0 and later