Developer

API Reference

IDNS_GetResponse()

Brew Release
Brew MP 1.0.2
See Also
Error Codes IDNS Network subsystem error codes
Description
This function is to be called to obtain the DNS response after the query completes.
On success, it returns a pointer to a structure with the description of the DNS response. Response data includes pointers to structures; the referenced memory will be valid only for the lifetime of the IDNS object. None of those pointers should be retained or used after the IDNS interface has been released.
Parameters
  • pIDNS
    []:
    The IDNS interface pointer.
  • pResp
    []:
    [out] A pointer to a structure describing the response.
Interface
Prototype
int IDNS_GetResponse(IDNS *pIDNS, const AEEDNSResponse **pResp);
Return
AEE_SUCCESS: A response message was received from a DNS server, where *pResp describes the result. Success here does not imply that the query was successful, just that a response was received. The application must inspect the AEEDNSResponse structure to determine whether the requested data is present in the response.
In all error cases, *pResp will point to an empty AEEDNSResponse structure. No assumptions should be made about the contents. Some possible error codes include:
  • ENOMEMORY: A memory allocation failure prevented the request or a response.
  • AEE_NET_ETIMEDOUT: A retransmission timeout (no servers responded).
Other error codes are possible, including socket-level error codes such as AEE_NET_ENETNONET.
Side Effect
None.
Comment
None
  • Follow