hostname

Specifies the name of an area containing the name of the host to resolve.

hostname-length

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

hostname and hostname-length are optional. If they are not specified, service-name and service-name-length must be specified.

The maximum value for this parameter is 256.

service-name

Specifies the name of an area containing the name of the service.

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.

service-name and service-name-length are optional. If they are not specified, hostname and hostname-length must be specified.

The maximum value for this parameter is 32.

pointer-to-input-addrinfo-structure

Specifies the name of a fullword field containing the address of an input ADDRINFO structure. The following fields in the ADDRINFO structure can be set: flags, family, socket type, and protocol. If this pointer is assigned to NULL, it is equivalent to an ADDRINFO structure where all fields are set to 0.

pointer-to-output-addrinfo-structure

Specifies the name of a fullword field that contains the address of the output ADDRINFO structure returned by the system. This structure has to be explicitly released by the user using the FREEADDRINFO #SOCKET call.

canonical-name-length

Specifies the name of a fullword field in which the system returns the length of the canonical name. The system returns the canonical name in the first output ADDRINFO structure if hostname is specified and the AI_CANONNAMEOK flag is set in the input ADDRINFO structure. If the canonical name length is not needed, canonical-name-length can be omitted.