| INT GetRecord( |
| |
LPCTSTR lpszHostName, |
|
| |
INT nRecordType, |
|
| |
LPTSTR lpszBuffer, |
|
| |
INT nMaxLength |
|
| ); |
| INT GetRecord( |
| |
LPCTSTR lpszHostName, |
|
| |
INT nRecordType, |
|
| |
CString& strBuffer |
|
| ); |
The GetRecord method returns the specified record
information for the given hostname.
Parameters
- lpszHostName
- Pointer to the string which specifies the host name that
information will be returned for.
- nRecordType
- The record type for the information that should be returned.
The following record types are recognized:
| Value |
Constant |
Description |
| 0 |
DNS_RECORD_NONE |
No record type |
| 1 |
DNS_RECORD_ADDRESS |
Host address |
| 2 |
DNS_RECORD_NS |
Authoritative nameserver |
| 5 |
DNS_RECORD_CNAME |
Canonical name (alias) |
| 6 |
DNS_RECORD_SOA |
Start of Authority |
| 11 |
DNS_RECORD_WKS |
Well known services |
| 12 |
DNS_RECORD_PTR |
Domain name |
| 13 |
DNS_RECORD_HINFO |
Host information |
| 14 |
DNS_RECORD_MINFO |
Mailbox information |
| 15 |
DNS_RECORD_MX |
Mail exchange host |
| 16 |
DNS_RECORD_TXT |
Text strings |
| 29 |
DNS_RECORD_LOC |
Location information |
| 100 |
DNS_RECORD_UINFO |
User information |
| 101 |
DNS_RECORD_UID |
User ID |
| 102 |
DNS_RECORD_GID |
Group ID |
- 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 information buffer is
returned. A return value of zero indicates that no information for
that record 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 GetRecord method can be used to resolve a host name
into an IP address using the record type DNS_RECORD_ADDRESS. It can
also be used to perform a reverse lookup and resolve an IP address
into a host name by using the record type DNS_RECORD_PTR.
To determine the host that serves as the primary or master DNS for
a zone, the record name should be specified as the domain name (e.g.:
microsoft.com) and the record type should be DNS_RECORD_SOA. The
value returned will the fully qualified domain name for host.
Note that this method does not reference a local host file when
resolving host names or addresses. If the record lookup fails, this
method will return an error even if there's an entry for the host in
the file that has been specified by a call to SetHostFile.
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
GetHostAddress,
GetHostName,
GetHostInfo,
GetHostServices,
GetMailExchange,
GetResolverAddress,
RegisterServer
|