HardTotals.Write Method (POS for .NET v1.12 SDK Documentation)

2/27/2008

Writes data to a totals file.

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

Syntax

'Declaration
Public MustOverride Sub Write ( _
    handle As Integer, _
    data As Byte(), _
    offset As Integer _
)

public abstract void Write (
    int handle,
    byte[] data,
    int offset
)

public:
virtual void Write (
    int handle, 
    array<unsigned char>^ data, 
    int offset
) abstract

public abstract void Write (
    int handle, 
    byte[] data, 
    int offset
)

public abstract function Write (
    handle : int, 
    data : byte[], 
    offset : int
)

If a transaction is in progress, the write will be buffered until a CommitTrans or Rollback method is called.

Write may cause a PosControlException to be thrown with one of the following ErrorCodes.

Value	Meaning
Claimed	Cannot write data because either the totals file or the totals area is claimed by another application.
Illegal	The handle is invalid, or part of all the data range is outside the bounds of the totals file.
Extended	ExtendedErrorNoRoom:Cannot write because a transaction is in progress, and there is insufficient free space to prepare for the transaction commit. ExtendedErrorValidation:A validation error has occurred while you read data.

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