gethostname
The Windows
Sockets gethostname function returns the standard host name for the
local machine.
int gethostname (
|
char FAR *
name, |
|
|
int namelen |
|
|
); |
|
Parameters
name
[out] A
pointer to a buffer that will receive the host name.
namelen
[in] The
length of the buffer.
Remarks
This routine
returns the name of the local host into the buffer specified by the name parameter.
The host name is returned as a null-terminated string. The form of the host
name is dependent on the Windows Sockets provider it can be a simple host name, or it can be a fully
qualified domain name. However, it is guaranteed that the name returned will be
successfully parsed by gethostbyname and WSAAsyncGetHostByName.
Note If no local
host name has been configured gethostname must succeed and return a
token host name that gethostbyname or WSAAsyncGetHostByName can
resolve.
Return Values
If no error
occurs, gethostname returns zero. Otherwise, it returns SOCKET_ERROR and
a specific error code can be retrieved by calling WSAGetLastError.
Error Codes
|
WSAEFAULT |
The name
argument is not a valid part of the user address space, or the buffer size
specified by namelen argument is too small to hold the complete host
name. |
|
WSANOTINITIALISED |
A
successful WSAStartup
must occur before using this function. |
|
WSAENETDOWN |
The network
subsystem has failed. |
|
WSAEINPROGRESS |
A blocking
Windows Sockets 1.1 call is in progress, or the service provider is still
processing a callback function. |
See Also