| |
| 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-byte 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
Client: Requires Windows 7, Windows Vista or Windows
XP.
Server: Requires Windows Server 2008 or Windows Server
2003.
Header: Include cstools7.h.
Library: Use csdnsav7.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
GetHostByAddress, GetHostByName, GetHostInfo, GetHostServices, GetRecord, GetResolverAddress, RegisterServer, EnumMailExchanges
|
|