gethostname()函数

简述：

　　返回本地主机的标准主机名。

　　#include <Winsock2.h>

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

　　name： 一个指向将要存放主机名的缓冲区指针。

　　namelen：缓冲区的长度。

编辑本段注释：

　　该函数把本地主机名存放入由name参数指定的缓冲区中。返回的主机名是一个以 NULL结束的 字符串。主机名的形式取决于 Windows Sockets实现－它可能是一个简单的主机名，或者是一个域名。然而，返回的名字必定可以在gethostbyname()和WSAAsyncGetHostByName()中使用。

返回值：

　　如果没有错误发生，gethostname()返回0。否则它返回SOCKET_ERROR。应用程序可以通过WSAGetLastError()来得到一个特定的错误代码。

错误代码：

　　WSAEFAULT 名字长度参数太小。

　　WSANOTINTIALISED 在应用这个API前，必须成功地调用WSAStartup()。

　　WSAENTDOWN Windows Sockets实现检测到了网络子系统的错误。

　　WSAEINPROGRESS 一个阻塞的Windows Sockets操作正在进行。

　　参见：gethostbyname(), WSAAsyncGetHostByName()