gethostname

9/8/2008

Essa função retorna o padrão nome do host para o local máquina.

Syntax

int gethostname(
  char FAR* name,
  int namelen
);

Parameters

• Nome
  [out] Ponteiro para uma reserva que recebe o local nome do host.

• namelen
  [no] Comprimento da reserva.

Return Value

Se não houver erro, essa função retornará zero. Se um erro ocorrer, ele retorna SOCKET_ERROR, e um código de erro específicos podem ser recuperadas por chamado WSAGetLastError.

A seguinte tabela mostra os códigos de erro possível.

Código de erro	Descrição
WSAEFAULT	O Nome parâmetro não é um válido parte espaço de endereço o usuário, ou o tamanho do buffer especificado pelo namelen parâmetro é muito pequeno para conter o completo nome do host.
WSANOTINITIALISED	Um bem-sucedido WSAStartup chamar deve ocorrer antes de usar essa função.
WSAENETDOWN	Falha no subsistema da rede.
WSAEINPROGRESS	Um bloqueio é chamar sockets do Windows (Winsock) em andamento, ou o serviço provedor ainda é processamento um função callback.

Remarks

Essa função retorna o nome do local hospedar para a reserva especificada pelo Nome parâmetro. O nome do host é retornado como um seqüência de caracteres NULL-Terminated. A forma do nome do host é dependente no provedor de Soquetes do Windows. Ele pode ser uma nome do host simples ou um nome domínio totalmente qualificado. No entanto, ele é garantido que o nome retornado será analisado com êxito por gethostbyname Ou getaddrinfo.

Observação

Se nenhum local nome do host foi configurado, gethostname Deve ter êxito e retornar um token nome do host que gethostbyname Ou getaddrinfo pode resolver.

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

getaddrinfo
gethostbyname
WSAGetLastError
WSAStartup