Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TIPHostName
Inherited By:
None.
Purpose:
Identifies a host (machine) by its name in DNS (the Domain Name Service). TDNSHostName is derived from TIPHostName.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
You should not derive any classes from TIPHostName.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
Other Considerations:
None.
TDNSHostName (const TText & hostName)
Interface Category:
API.
Purpose:
Creates an object that identifies a host by its DNS name.
Calling Context:
Called to create a name for a host.
Parameters:
- const TText & hostName -A DNS name.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TDNSHostName ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Member Function: TDNSHostName::GetLocalHostName
static void GetLocalHostName (TText & hostName)
Interface Category:
API.
Purpose:
Returns the name of the host (machine) on which the calling thread is running.
Calling Context:
Called to get the local host's name. For example, this function is used by TNetworkServiceDefinition::CreateServiceReference, to construct a service reference that contains the DNS name of the local host.
Parameters:
- TText & hostName -Filled in with the local host's fully-qualified DNS name.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.