The Simons     Component Library

           

---

DeviceBusy Class Reference

#include <DeviceBusy.h>

Inheritance diagram for DeviceBusy:

List of all members.

---

Detailed Description

DeviceBusy: signals that a device is already in use.

Raise a DeviceBusy exception when an attempt is made to interact with a device, which refuses the connection. The failure is because the device is already in use by another process and so the requesting process must wait until the device is available again. For example, if the FileStream locking protocol is turned on, then an attempt to open a locked file will raise a DeviceBusy exception. DeviceBusy provides access to the failed object(), the message() and the name() of the failed object.

Public Member Functions
	DeviceBusy ()
	Construct a default DeviceBusy.
virtual	~DeviceBusy ()
	Release a DeviceBusy.
	DeviceBusy (ObjectID, StringID)
	Construct a DeviceBusy exception.
virtual ObjectID	clone () const
	Clone a shallow copy of this DeviceBusy.
Protected Member Functions
	DeviceBusy (const DeviceBusy &)
	Copy another DeviceBusy.

---

Constructor & Destructor Documentation

DeviceBusy::DeviceBusy (  const DeviceBusy &  exception  )  [protected]

Copy another DeviceBusy. Required by C++ to ensure that copying a DeviceBusy faithfully copies a DeviceError. Parameters: exception  - the DeviceBusy to copy. Returns: a DeviceBusy, a shallow copy.

DeviceBusy::DeviceBusy (   )

Construct a default DeviceBusy. Returns: a DeviceBusy

DeviceBusy::~DeviceBusy (   )  [virtual]

Release a DeviceBusy.

DeviceBusy::DeviceBusy (  ObjectID  object, StringID  name )

Construct a DeviceBusy exception. Raised when an attempt is made to use a device, such as a filesystem, but the device is already in use. If the failed object refused a connection because it was already connected, handling this DeviceBusy exception will allow the failed object to resume its existing connection. If the failed object was denied access to a busy device, handling this DeviceBusy exception will allow the failed object to attempt to connect again later. Parameters: object  - the object which refused to make a connection. name  - the name of the connection which was refused. Returns: a DeviceBusy exception.

---

Member Function Documentation

ObjectID DeviceBusy::clone (   )  const [virtual]

Clone a shallow copy of this DeviceBusy. Returns: a DeviceBusy exception, a shallow copy. Reimplemented from Exception.

---

The documentation for this class was generated from the following files:

• DeviceBusy.h
• DeviceBusy.cc

---