Share via

PosPower.ShutdownPos Method

  • Article

2/27/2008

Shuts down the POS system independent of the power state.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride Sub ShutdownPos

public abstract void ShutdownPos ()

public:
virtual void ShutdownPos () abstract

public abstract void ShutdownPos ()

public abstract function ShutdownPos ()

Remarks

If the Claimed property for the PosPower device is set to true and an application that does not have the device claimed calls ShutdownPos, the service object throws a PosControlException exception.  We recommend that in a power failure situation, an application should call ShutdownPos after it saves all data and setting the application to a defined state.

If the CapShutdownPos property is false and the application tries to call the ShutdownPos method, the service object throws an Illegal exception.

If the EnforcedShutdownDelayTime property specifies a time greater than zero and the application did not call the ShutdownPos method within the time specified in EnforcedShutdownDelayTime, the system shuts down automatically. This mechanism can be provided by an underlying operating system to prevent the battery from being completely drained.

When the service object starts the system shutdown, it sends a StatusUpdateEvent event of StatusRestart to one or all applications, depending on whether the device is currently shareable.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

PosPower Class
PosPower Members
Microsoft.PointOfService Namespace