|
|
| INT
GetHostServices(
|
|
|
LPCTSTR
lpszHostName, |
|
|
|
|
INT nProtocol, |
|
|
|
|
LPTSTR
lpszBuffer, |
|
|
|
|
INT cbBuffer |
|
|
| );
|
The GetHostServices method returns the WKS (Well Known
Services) record for the specified hostname and protocol. This
information, if it is provided, typically specifies the names of
those services supported on the host.
Parameters
- lpszHostName
- Pointer to the string which specifies the host name that
information is to be returned about.
- nProtocol
- The protocol for those services that information should be
returned about. The following protocols are recognized:
-
| Value |
Constant |
Description |
| 6 |
DNS_PROTOCOL_TCP |
Services that use the Transmission Control
Protocol (TCP) |
| 17 |
DNS_PROTOCOL_UDP |
Services that use the User Datagram Protocol
(UDP) |
- 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 services 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 complete services records for a
site since that information can potentially be used to compromise
system security. An application should not depend on this
information being available for any given record.
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, GetHostInfo, GetMailExchange, GetRecord, GetResolverAddress, RegisterServer
|
|