Class: TNetworkServiceDefinition

Declaration: NetworkService.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TServiceDefinition

Inherited By:

None.

Purpose:

Defines a service that is visible on the network; that is, to clients in this machine and other machines in the same network. It is recommended that you not instantiate this class directly, but that you use the TStandardServiceDefinition class instead.

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:

Do not derive any classes from TNetworkServiceDefinition.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TNetworkServiceDefinition::TNetworkServiceDefinition

TNetworkServiceDefinition (const TLocalObjectName &)
TNetworkServiceDefinition ()

Interface Category:

API.

Purpose:

Creates a TNetworkServiceDefinition with the specified service name. The translation of the service name to a network name is performed in cooperation with the TNetworkServiceAdaptor.
Creates an anonymous network service.

Calling Context:

Called to create a network service with the specified name.
Called by the stream-in operators.

Parameters:

const TLocalObjectName & -The service name.
Takes no parameters.

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TNetworkServiceDefinition::CreateServiceReference

virtual TServiceReference * CreateServiceReference (TMemoryHeap * whereToCreate =NIL)

Interface Category:

API.

Purpose:

Returns a reference to the service defined by this object.

Calling Context:

Called to obtain a service reference for this service.

Parameters:

TMemoryHeap * whereToCreate =NIL -The heap from which storage should be allocated for the returned object.

Return Value:

A TServiceReference that contains the same service name and a reference to the same object directory as this object.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TNetworkServiceDefinition::~TNetworkServiceDefinition

virtual ~ TNetworkServiceDefinition ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called by the member function Unreachable to destroy this object when the reference count indicates this 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 is protected and should not be called directly.

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