Share via

PinPadBase.AdditionalSecurityInformation Property (POS for .NET v1.12 SDK Documentation)

  • Article

2/27/2008

Holds security/encryption information, formatted as a Hex-ASCII string, after a successful PIN entry operation in which the DataEvent event is queued to the application with a DataEventArgs.Status of Success.

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

Syntax

'Declaration
Public Overrides ReadOnly Property AdditionalSecurityInformation As String

public override string AdditionalSecurityInformation { get; }

public:
virtual property String^ AdditionalSecurityInformation {
    String^ get () override;
}

/** @property */
public String get_AdditionalSecurityInformation ()

public override function get AdditionalSecurityInformation () : String

Remarks

The content and internal format of this string will vary depending on the PIN Pad Management System being used. For example, for DUKPT-based key encryption, AdditionalSecurityInformation contains the PIN pad sequence number. If the user cancels the PIN entry operation, resulting in the DataEvent event DataEventArgs.Status property set to Cancel, AdditionalSecurityInformation will contain an empty string.

The PinPadBase class verifies that the PIN pad device has been opened, then retrieves the value of PinPadProperties.AdditionalSecurityInformation.

AdditionalSecurityInformation is initialized to blank by the PinPadProperties class.

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

PinPadBase Class
PinPadBase Members
Microsoft.PointOfService.BaseServiceObjects Namespace
PinPad.AdditionalSecurityInformation Property