gethostname

gethostname returns an ASCII string representation of the first IPv4 address configured on a system.

Syntax

int gethostname(
    char *name,
    int namelen
);

Parameters

name

A pointer to a buffer to store the name.

namelen

The length, in bytes, of the buffer pointed at by the name parameter.

Return Value

If the function succeeds, it returns 0 (zero). If the function fails, it returns SOCKET_ERROR.