Resolve Method

Resolves an email address.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int Resolve(const char* lpszEmailAddress);

Unicode (Windows)
INT Resolve(LPCWSTR lpszEmailAddress);

- (void)resolve:(NSString*)emailAddress;

#define MID_MX_RESOLVE 6

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_MX_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method resolves an email address. Calling this method directs the class to query DNSServer at port DNSPort about MX records related to EmailAddress.

The server's response is provided through one or more Response events.

After the query completes, the MailServer property is set to the best mail server and the Status property has the result description of the response.

Valid queries are email addresses like name@company.com or hostnames and domains like domain.com.

Example (Determine Top Priority Mail Server of Email Address)

MXControl.Resolve "email@server.com"
While MXControl.MailServer = ""
	MXControl.DoEvents()
End While
BestMailServer = MXControl.MailServer

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)