| |
| 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 character 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
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,
GetHostServices,
GetMailExchange,
GetRecord,
GetResolverAddress,
RegisterServer
|
|