TElBaseSocketClient.OnDNSResolve event

TElBaseSocketClient.OnDNSResolve

This event is fired when a host address needs to be resolved.

Declaration

[C#]
event TSBDNSResolveEvent OnDNSResolve;
delegate void TSBDNSResolveEvent(Object Sender, string HostName, TElDNSResourceRecordSet Response, int ResolveResult, byte SecurityStatus);

[VB.NET]
Event OnDNSResolve As TSBDNSResolveEvent
Delegate Sub TSBDNSResolveEvent(ByVal Sender As Object, ByVal HostName As String, ByVal Response As TElDNSResourceRecordSet, ByVal ResolveResult As Integer, ByVal SecurityStatus As Byte)

[Pascal]
property OnDNSResolve : TSBDNSResolveEvent;
TSBDNSResolveEvent = procedure(Sender : TObject; const HostName : string; Response : TElDNSResourceRecordSet; ResolveResult : Integer; SecurityStatus : TSBDNSSecurityStatus) of object;

[C++]
    void get_OnDNSResolve(TSBDNSResolveEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnDNSResolve(TSBDNSResolveEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBDNSResolveEvent)(void * _ObjectData, TObjectHandle Sender, const char * pcHostName, int32_t szHostName, TElDNSResourceRecordSetHandle Response, int32_t ResolveResult, TSBDNSSecurityStatusRaw SecurityStatus);

[PHP]
    TSBDNSResolveEvent|callable|NULL get_OnDNSResolve()
    void set_OnDNSResolve(TSBDNSResolveEvent|callable|NULL $Value)
    callable TSBDNSResolveEvent(TObject $Sender, string $HostName, TElDNSResourceRecordSet $Response, integer $ResolveResult, integer $SecurityStatus)

[Java]
    TSBDNSResolveEvent getOnDNSResolve();
    void setOnDNSResolve(TSBDNSResolveEvent Value);
    TSBDNSResolveEvent.Callback OnDNSResolve = new TSBDNSResolveEvent.Callback() {
        public void TSBDNSResolveEventCallback(TObject Sender, String HostName, TElDNSResourceRecordSet Response, int ResolveResult, byte SecurityStatus) {
            //...
        }
    }

Parameters

HostName - name of the host to be resolved
Response - resource record received from the resolver
ResolveResult - DNS resolution result
SecurityStatus - security status of the DNS resource record set
pcHostName - name of the host to be resolved.
szHostName - the length of pcHostName.

TSBDNSSecurityStatus values

[.NET]	[Pascal]	[C++]	Description
dnsInsecure = 1	dnsInsecure	f_dnsInsecure = 1	there is no chain of trust from any trusted starting point to the RRset
dnsIndeterminate = 2	dnsIndeterminate	f_dnsIndeterminate = 2	the data is signed but there is no trusted key to verify the signature
dnsBogus = 4	dnsBogus	f_dnsBogus = 4	the resolver believes that it ought to be able to establish a chain of trust for the RRset, but it is unable to do so
dnsSecure = 8	dnsSecure	f_dnsSecure = 8	the resolver is able to build a chain of trust for the RRset

DNS lookup results

Definition		Value
SB_DNS_RESULT_SUCCESS		0 (0x0)
SB_DNS_RESULT_FIRST		42752 (0xA700)
SB_DNS_RESULT_NAME_NOT_FOUND		42752 (0xA700)
SB_DNS_RESULT_INFO_NOT_FOUND		42753 (0xA701)
SB_DNS_RESULT_SERVER_FAILURE		42754 (0xA702)
SB_DNS_RESULT_TIMEOUT		42755 (0xA703)
SB_DNS_RESULT_LAST		42755 (0xA703)

Description

This event is fired by TElBaseSocketClient when DNS resolving has been performed.

Discuss this help topic in SecureBlackbox Forum