1.2.1.7.22 TCPIP_DNS_EntryQuery Function

C

TCPIP_DNS_RESULT TCPIP_DNS_EntryQuery(
    TCPIP_DNS_ENTRY_QUERY * pDnsQuery, 
    int queryIndex
);

Description

This function is used to query the DNS client for a specified entry. The entry to be queried is selected by its index.

Preconditions

The DNS client module must be initialized.

Parameters

ParametersDescription
pDnsQueryAddress to store the the query result.
queryIndexEntry index to be selected; should start with 0.

Returns

  • TCPIP_DNS_RES_OK - valid address for this index, successful.

Errors:

  • TCPIP_DNS_RES_NO_SERVICE - DNS resolver non existent/uninitialized.

  • TCPIP_DNS_RES_INVALID_HOSTNAME - invalid string, len, pDnsQuery provided.

  • TCPIP_DNS_RES_EMPTY_IX_ENTRY - no name associated with this entry.

  • TCPIP_DNS_RES_NO_IX_ENTRY - invalid query index.

Remarks

None.