| |
| INT GetHostServices( |
| |
LPCTSTR lpszHostName, |
|
| |
INT nProtocol, |
|
| |
LPTSTR lpszBuffer, |
|
| |
INT nMaxLength |
|
| ); |
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 will be returned for.
- 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.
- 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 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
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,
GetHostInfo,
GetMailExchange,
GetRecord,
GetResolverAddress,
RegisterServer
|
|