gethostbyaddr

9/8/2008

Essa função recupera as informações hospedar correspondente para um endereço rede.

Observação

A função GetHostbyaddr foi substituído pela introdução das getnameinfo função.Os desenvolvedores que criam aplicativos 2 Soquetes do Windows são incentivados a usar a função getnameinfo instead of a função GetHostbyaddr.Consulte " Comentários ".

Syntax

struct hostent FAR* gethostbyaddr(
  const char FAR* addr,
  int len,
  int type
);

Parameters

• addr
  [no] Ponteiro para um endereço na rede byte order.

• Len
  [no] Comprimento do endereço.

• tipo
  [no] Tipo do endereço, como o AF_INET tipo família de endereços (definido como TCP, UDP e outros associado protocolos Internet). Endereço família tipos e seus correspondente valores são definidos no arquivo de cabeçalho Winsock2.h.

Return Value

Se não houver erro, essa função retorna um ponteiro para o hostent estrutura que contém o nome e endereço correspondente ao endereço de rede fornecido. Se ocorrer um erro, ele retornará um NULL ponteiro e um código de erro específicos podem ser recuperadas por chamado WSAGetLastError.

A seguinte tabela mostra uma lista dos códigos de erro possível.

Código de erro	Descrição
WSANOTINITIALISED	Um bem-sucedido WSAStartup chamar deve ocorrer antes de usar essa função.
WSAENETDOWN	Falha no subsistema da rede.
WSAHOST_NOT_FOUND	Hospedar uma resposta com autoridade não foi encontrado.
WSATRY_AGAIN	Não foi encontrado um hospedar não autoritativo, ou falha de servidor.
WSANO_RECOVERY	Ocorreu um erro não recuperável.
WSANO_DATA	Um válido nome existe, mas não registro de dados do tipo solicitado existe.
WSAEINPROGRESS	Um bloqueio é chamar sockets do Windows (Winsock) em andamento, ou o serviço provedor ainda é processamento um função callback.
WSAEAFNOSUPPORT	O tipo especificado não é com suporte pela implementação Soquetes do Windows.
WSAEFAULT	O addr parâmetro não é um válido parte espaço de endereço de usuário, ou a Len parâmetro é muito pequeno.
WSAEINTR	O Soquete foi fechada.

Remarks

Embora GetHostbyaddr é substituído pelo getnameinfo função, GetHostbyaddr é capaz de retornar um nome NetBIOS; getnameinfo não é. Os desenvolvedores que precisam de NetBIOS resolução de nomes talvez precise usar GetHostbyaddr até que seus aplicativos são completamente independentes de nomes NetBIOS.

Observação

A funcionalidade para inverter executar pesquisas usando o GetHostbyaddr função é conveniente, mas essas pesquisas são consideradas Inerentemente não confiável e deve ser usado apenas como uma dica.

Requirements

Header	winsock2.h
Library	Ws2.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

gethostbyname
hostent
WSAGetLastError
WSAStartup