Jump to main content

##

# 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

Parameters | Description
--- | ---
pDnsQuery | Address to store the the query result.
queryIndex | Entry 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.