Asynchronous DNS resolving function.

This function use DNS to resolve a domain name into the corresponding IP address. A call to this function will cause a DNS request to be sent and the response will be delivered to the DNS callback function registered using registerSocketCallback()

Functions
NMI_API sint8	gethostbyname (uint8 *pcHostName)

NMI_API sint8 gethostbyname ( uint8 * pcHostName )

Parameters

[in] pcHostName NULL terminated string containing the domain name for the remote host. Its size must not exceed HOSTNAME_MAX_SIZE.

Warning: Successful completion of a call to gethostbyname() does not guarantee success of the DNS request, a negative return value indicates only locally-detected errors

See Also: registerSocketCallback

Returns

         Asynchronous DNS resolving function. This function uses DNS to resolve a domain name to the corresponding IP address.
         A call to this function will cause a DNS request to be sent and the response will be delivered to the DNS callback
         function registered using registerSocketCallback.

Parameters

[in] pcHostName NULL terminated string containing the domain name for the remote host. Its size must not exceed HOSTNAME_MAX_SIZE.

See Also: registerSocketCallback

Warning: Successful completion of a call to gethostbyname() does not guarantee success of the DNS request, a negative return value indicates only locally-detected errors

Returns

Microchip® Advanced Software Framework

Functions