| |
| INT GetMailExchange( |
| |
LPCTSTR lpszHostName, |
|
| |
LPINT lpnPreference, |
|
| |
LPTSTR lpszBuffer, |
|
| |
INT nMaxLength |
|
| ); |
The GetMailExchange method returns the mail exchange (MX)
record information for the specified domain. This information, if it
is provided, identifies a server responsible for processing mail for
the given domain.
Parameters
- lpszHostName
- Pointer to the string which specifies the host name that
information will be returned for.
- lpnPreference
- Pointer to the integer which will contain the preference for
the specified mail exchange host.
- lpszBuffer
- Pointer to the buffer which will contain the host information
returned by the nameserver.
- nMaxLength
- Maximum number of characters that may be copied into the
specified buffer, including the null character terminator.
Return Value
If the method succeeds, the length of the buffer is returned. A
return value of zero indicates that no information is available for
the specified host. If the method fails, the return value is
DNS_ERROR. To get extended error information, call
GetLastError.
Remarks
The mail exchange record is typically used by mail delivery agents
to determine what system is responsible for accepting mail addressed
to a given domain. This method will return the first MX record
provided by the server. Note that some domains may have multiple mail
servers. To enumerate all of the mail exchange records for a domain,
use the EnumMailExchanges method.
Requirements
Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
Import Library: csdnsv10.lib
Unicode: Implemented as Unicode and ANSI versions.
See Also
GetHostByAddress,
GetHostByName,
GetHostInfo,
GetHostServices,
GetRecord,
GetResolverAddress,
RegisterServer,
EnumMailExchanges
|
|