%SS_GETHOSTBYADDR

Get the host name corresponding to an IPv4 address

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
Note

The %SS_GETHOSTBYADDR routine is deprecated (because it is based on a deprecated Winsock function). We recommend using %SS_GETNAMEINFO instead.

status = %SS_GETHOSTBYADDR(in_addr, h_name)

Return value

status

If successful, returns SS_SUCCESS (0). If unsuccessful, returns SS_ENULL (2). See the Socket Errors table for additional information about this error. (n)

Arguments

in_addr

Specifies an IPv4 address. (i4)

h_name

Returned with the host name. (a)

Discussion

%SS_GETHOSTBYADDR retrieves a host name using the host address in_addr as a search parameter.

If SS_ENULL is returned, the system error code can be returned by immediately calling %SYSERR.