| |
| INT GetHostInfo(
|
| |
LPCTSTR lpszHostName, |
|
| |
LPTSTR lpszBuffer, |
|
| |
INT nMaxLength |
|
| );
|
The GetHostInfo method returns the HINFO record for the
specified hostname. This information, if it is provided, typically
specifies the operating system type and hardware platform.
Parameters
- lpszHostName
- Pointer to the string which specifies the host name that
information will be returned for.
- 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 host information
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
Many systems to do not maintain HINFO records for a site since
that information can potentially be used to compromise system
security. The information is typically used for administrative
purposes with internal networks.
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, GetHostServices, GetMailExchange, GetRecord, GetResolverAddress, RegisterServer
|
|