Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function is used to register the host name on a network with the Windows Internet Naming Service (WINS).
int sethostname( char* pName,int cName);
Parameters
- pName
[in] Pointer to the host name. - cName
[in] Length of the host name.
Return Values
If no error occurs, this function returns zero. If an error occurs, this function returns a value of SOCKET_ERROR, and retrieves a specific error code by calling WSAGetLastError.
The following table shows possible error codes for this function.
| Error code | Description |
|---|---|
| WSAEFAULT | The name parameter is not a valid part of the user address space, or the buffer size specified by the cName parameter is too small to hold the complete host name. |
| WSAEINVAL | One of the parameters is invalid. |
| WSAENETDOWN | The network subsystem failed. |
| WSAEALREADY | The host already is the name specified. |
Requirements
OS Versions: Windows CE 1.0 and later.
Header: Winsock2.h.
Link Library: Ws2.lib.
See Also
Send Feedback on this topic to the authors