gethostbyname

9/8/2008

Essa função recupera hospedar informações correspondente a um nome do host de um banco de dados hospedar.

Observação

A função gethostbyname foi substituído pela introdução das getaddrinfo função.Os desenvolvedores que criam aplicativos 2 Soquetes do Windows são incentivados para usar a função getaddrinfo em vez de gethostbyname.

Syntax

struct hostent FAR* gethostbyname(
  const char FAR* name 
);

Parameters

• Nome
  [out] Ponteiro para o nome de terminação nula da hospedar a resolver.

Return Value

Se não houver erro, essa função retorna um ponteiro para o hostent estrutura. Se ocorrer um erro, ele retornará um NULL ponteiro e um número de erro específicas podem ser recuperadas por chamado WSAGetLastError.

A seguinte tabela mostra os 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.
WSAEFAULT	O Nome parâmetro não é um válido parte espaço de endereço o usuário.
WSAEINTR	O Soquete foi fechada.

Observação

Japanese Version Winsock chama a get o endereço IP máquina falhará se o nome da máquina é inserida em caracteres em japonês.

Remarks

Essa função retorna um ponteiro para um hostent estrutura, que é uma estrutura alocada pelo Soquetes do Windows. O hostent estrutura contém os resultados de um bem-sucedido pesquisa para a hospedar especificado na Nome parâmetro.

O aplicativo deve tentar modificar essa estrutura nunca ou para livre algo dentro de estrutura Além disso, somente um copiar dessa estrutura é alocada por segmento, portanto, o aplicativo deve copiar as informações necessárias antes da emissão quaisquer outras chamadas função Soquetes do Windows.

Essa função não é possível resolver IP endereço seqüências de caracteres passadas para ela. Tal uma solicitação é tratada exatamente como se um nome do host desconhecidos foram passados. Uso inet_addr Para converter um seqüência de caracteres endereço IP para um real endereço IP, em seguida, use outra função, GetHostbyaddr, para obter o conteúdo de hostent estrutura.

O gethostbyname função resolve a seqüência de caracteres retornado por um bem-sucedido chamar para gethostname.

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

gethostbyaddr
gethostname
hostent
inet_addr
WSAGetLastError
WSAStartup