Previous Topic: GETNAMEINFONext Topic: Notes


Parameters

Parameter

Description

sockaddr

Specifies the name of the sockaddr structure containing the information that must be resolved: the domain (or socket family), the port number and the IP address.

sockaddr-length

Specifies the name of a fullword field containing the length of sockaddr. sockaddr-length can be specified as an absolute expression.

The maximum value for this parameter is domain dependent. If the domain is AF_INET, it is the length of the SOCKET-SOCKADDR-IN record (SIN#LEN for Assembler). If the domain is AF_INET6, it is the length of the SOCKET-SOCKADDR-IN6 record (SIN6#LEN for Assembler).

service-name

Specifies the name of an area where the system returns the service name corresponding to the port number specified in the sockaddr structure.

service-name-length

Specifies the name of a fullword field containing the length of service-name. service-name-length can be specified as an absolute expression.

The maximum value for this parameter is 4096. .row

returned-service-name-length

Specifies the name of a fullword field into which the actual length of the service name is returned. service-name, service-name-length and returned-service-name-length are optional; specify all three parameters, or none of them. If none of these parameters are specified, hostname, hostname-length, and returned-hostname-length must be specified.

hostname

Specifies the name of an area where the system returns the hostname corresponding to the IP address specified in the sockaddr structure.

hostname-length

Specifies the name of a fullword field containing the length of hostname. hostname-length can be specified as an absolute expression.

The maximum value for this parameter is 4096.

returned-hostname-length

Specifies the name of a fullword field into which the length of the host name is returned.

hostname, hostname-length and returned-hostname-length are optional; specify all three parameters, or none of them. If none of these parameters are specified, service-name, service-name-length, and returned-service-name-length must be specified.

flags

Specifies the name of a fullword field containing flags to control the resolution of the socket address.