IP*Works! MX Component : MX OCX, MX .NET Component, MX Class, MX Bean, MX Object

Available in: IP*WORKS!

MX Component [IP*Works! V8]

Properties Methods Events Configuration Settings

The MX component enables querying of mail exchange (MX) records from a Domain Name Server (DNS). That is, it will find out the name(s) of the mail server(s) accepting email for a given email address or domain.

NOTE: What follows is a very short description of the component interfaces. For more information, please consult the help files that come with the respective package.

Remarks

The component will attempt to automatically determine the name of a DNS server from the system settings or from the value of the DNSServer property.

The component operates in synchronous or asynchronous mode, depending on the value of the Timeout property. Calling the Resolve method makes the component query the DNSServer. The Response event is fired for each server that handles mail for the email address. The component will fill out the MailServer property with the most preferred mail server and the Status property to "Ok" or an error message.

The RequestId property may be used to identify requests and is used in the Response event. The user may set its value before sending out requests, and then match the responses to the request using the RequestId parameter in the Response event.

Property List

The following is the full list of the properties of the component with short descriptions. Click on the links for further details.


DNSPort	The port where the DNS server is listening.
DNSServer	The address of the DNS Server.
Idle	The current status of the component.
LocalHost	The name of the local host or user-assigned IP interface through which connections are initiated or accepted.
MailServer	Mail server with lowest precedence value (lowest cost to reach).
RequestId	Identifies each request.
Status	Status of the request: empty while in progress, 'OK' or error message upon completion.
Timeout	A timeout for the component.

Method List

The following is the full list of the methods of the component with short descriptions. Click on the links for further details.


Config	Sets or retrieves a configuration setting.
DoEvents	Processes events from the internal message queue.
Interrupt	Interrupt the current method.
Resolve	Resolve an email address.

Event List

The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.


Error	Information about errors during data delivery.
Response	Fired for each MailServer accepting email for the domain.

Configuration Settings

The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.


MaxPacketSize	The maximum length of the packets that can be received
ShareLocalPort	If set to True, allows more than one instance of the component to be active on the same local port
UseConnection	Determines whether to use a connected socket
QOSTrafficType	Used to specify QOS/DSCP settings (optional)
UseIPv6	Whether or not to use IPv6
AbsoluteTimeout	Determines whether timeouts are inactivity timeouts or absolute timeouts
FirewallData	Used to send extra data to the firewall
InBufferSize	The size in bytes of the incoming queue of the socket
OutBufferSize	The size in bytes of the outgoing queue of the socket
CodePage	The system code page used for Unicode to Multibyte translations