Class: TStandardServiceDefinition

Declaration: ServiceAccess.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TServiceDefinition

Inherited By:

None.

Purpose:

Defines a standard Taligent service. TServiceDefinition is a wrapper for either a TLocalServiceDefinition or a TNetworkServiceDefinition.

Instantiation:

Always allocate on the heap. This class is reference counted and deletes itself when it becomes unreachable and, therefore, must be allocated on the heap.

Deriving Classes:

You should not derive any classes from TServiceDefinition.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TStandardServiceDefinition::TStandardServiceDefinition

TStandardServiceDefinition ()
TStandardServiceDefinition (const TLocalObjectName &)
TStandardServiceDefinition (const TLocalObjectName &, const TQualityOfService &)

Interface Category:

API.

Purpose:

Creates a local service definition, with an invented unique name.
Creates a TLocalServiceDefinition with the specified local name.
Creates a service definition with the specified name. If the quality of service argument is kSameHost, a TLocalServiceDefinition is created. If the quality of service argument is kNetwork, a TNetworkServiceDefinition is created.

Calling Context:

Called to create a locally-visible service.
Called to create a locally-visible service with a particular name.
Called to create a service with a particular name and visibility.

Parameters:

Takes no parameters.
const TLocalObjectName & -The name to use.
const TLocalObjectName & -The name to use.
const TQualityOfService & -The quality of service.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

TStandardServiceDefinition that are unnamed are only visible on the host (machine) on which they are created.

Member Function: TStandardServiceDefinition::~TStandardServiceDefinition

virtual ~ TStandardServiceDefinition ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called by the Unreachable() member function when the reference count indicates the object is no longer accessible.

Parameters:

Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

This member function should not be called directly.

Click the icon to mail questions or corrections about this material to Taligent personnel.