LookupHost

LookupHost overloads

Synopses

Declared in <netbase.h>

Resolve a host string to its first corresponding network address.

std::optional<CNetAddr>
LookupHost(
    std::string const& name,
    bool fAllowLookup,
    DNSLookupFn dns_lookup_function = g_dns_lookup);
» more...

Resolve a host string to its corresponding network addresses.

std::vector<CNetAddr>
LookupHost(
    std::string const& name,
    unsigned int nMaxSolutions,
    bool fAllowLookup,
    DNSLookupFn dns_lookup_function = g_dns_lookup);
» more...

Return Value

  • The resulting network address to which the specified host string resolved or std::nullopt if host does not resolve to an address.
  • The resulting network addresses to which the specified host string resolved.

Parameters

NameDescription
nameThe host name or numeric address to resolve.
fAllowLookupWhether DNS lookups are permitted.
dns_lookup_functionThe resolver used to perform the lookup.
nMaxSolutionsThe maximum number of addresses to return; 0 means no limit.

See Also

LookupHost(const std::string&, unsigned int, bool, DNSLookupFn) for additional parameter descriptions.

Lookup(const std::string&, uint16_t, bool, unsigned int, DNSLookupFn) for additional parameter descriptions.