簡述
返回本地主機的標準主機名。
#include <winsock.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()