Platform SDK: SMTP Server Events

IDnsResolverRecord Interface

[This is preliminary documentation and subject to change.]

The IDnsResolverRecord interface defines a set of collection methods that must be implemented by a DNS resolver sink.

IID
e5b89c52-8e0b-11d2-94f6-00C04f79f1d6
Extends
IUnknown

Methods

Method Description
GetItem Returns an indexed DNS record from the resolver sink.
Count Returns the number of records contained by the resolver sink.

Remarks

When implementing a DNS resolver sink, your sink COM object must expose the IDnsResolverRecord interface. Resolver sinks are requested when the SMTP connection manager requires resolution of DNS host names to IP addresses. The event dispatcher calls the IDnsResolverRecordSink::OnSyncGetResolverRecord event method to notify each registered sink, and each in turn returns its IDnsResolverRecord object reference (interface) to the caller. This reference is then used to request resolution of DNS names to IP addresses.

DNS resolver sinks must use a zero-based sequential index for records in the collection. When records are required, the sink's record collection will be enumerated from zero to Count - 1 until the desired record is found, or no match is found. If a match is not found, the resolution of the DNS name is attempted directly using the configured DNS server on the network.