DNSResolve Function

Microchip TCP/IP Stack

previous page next page
Microchip TCP/IP Stack Help
Contents | Index | Home
Previous | Up | Next
DNSResolve Function
C
void DNSResolve(
    BYTE* HostName, 
    BYTE Type
);
Description

This function attempts to resolve a host name to an IP address. When called, it starts the DNS state machine. Call DNSIsResolved repeatedly to determine if the resolution is complete. 

Only one DNS resoultion may be executed at a time. The Hostname must not be modified in memory until the resolution is complete.

Preconditions

DNSBeginUsage returned TRUE on a previous call.

Parameters
Parameters 
Description 
Hostname 
A pointer to the null terminated string specifiying the host for which to resolve an IP. 
RecordType 
DNS_TYPE_A or DNS_TYPE_MX depending on what type of record resolution is desired. 
Returns

None

Remarks

This function requires access to one UDP socket. If none are available, MAX_UDP_SOCKETS may need to be increased.

Stack API > DNS > Public Members > DNSResolve Function
Microchip TCP/IP Stack 5.42.08 - June 15, 2013
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.
Contents | Index | Home
previous page start next page