gethostname Function

C

int gethostname(
    char* name, 
    int namelen
);

Description

This function returns the standard host name of the system which is calling this function. The returned name is null-terminated.

Preconditions

None.

Parameters

ParametersDescription
namePointer to a buffer that receives the local host name.
namelenSize of the name array.

Returns

  • 0 - The function was successful.

  • SOCKET_ERROR (-1) - Name is too short to hold the host name or any other error occurs. errno is set accordingly and *name will be unmodified and no null terminator will be generated.

Remarks

The function returns the host name as set on the default network interface.