CDnsClient::GetHostInfo
INT GetHostInfo(
LPCTSTR lpszHostName,  
LPTSTR lpszBuffer,  
INT cbBuffer  
);

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 is to be returned about.
lpszBuffer
Pointer to the buffer which will contain the host information returned by the nameserver.
cbBuffer
Maximum number of bytes 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 Vista, Windows XP or Windows 2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or Windows 2000 Server.
Header: Include cstools6.h.
Library: Use csdnsav6.lib.
Unicode: Implemented as Unicode and ANSI versions.

See Also

GetHostByAddress, GetHostByName, GetHostServices, GetMailExchange, GetRecord, GetResolverAddress, RegisterServer


Copyright © 2008 Catalyst Development Corporation. All rights reserved.