TElCustomTSPClient.Timestamp method

TElCustomTSPClient.Timestamp

Performs request to the server

Declaration

[C#]
int Timestamp(byte[] HashedData, out TSBPKIStatus ServerResult, out int FailureInfo, out byte[] ReplyCMS);

[VB.NET]
Function Timestamp(ByVal HashedData As Byte(), Out ServerResult As TSBPKIStatus, Out FailureInfo As Integer, Out ReplyCMS As Byte()) As Integer

[Pascal]
function Timestamp(const HashedData: ByteArray; out ServerResult: TSBPKIStatus; out FailureInfo: integer; out ReplyCMS : ByteArray) : Integer;

[C++]
int32_t Timestamp(const std::vector<uint8_t> &HashedData, TSBPKIStatus &ServerResult, int32_t &FailureInfo, std::vector<uint8_t> &ReplyCMS);

[PHP]
integer Timestamp(array of byte|string|NULL $HashedData, integer &$ServerResult, integer &$FailureInfo, array of byte|string &$ReplyCMS)

[Java]
int timestamp(byte[] arg0, TElTSPReply arg1);

Parameters

HashedData - data hash (digest) to be timestamped
ServerResult - request execution result as returned by server. Corresponds to PKIStatus field in the TSP reply structure.
FailureInfo - error information as returned by server
ReplyCMS - timestamp signature body

PKIStatus possible values:

[.NET] [C++]	[Pascal]	Description
psGranted = 0	psGranted	when the PKIStatus contains the value zero a TimeStampToken, as requested, is present
psGrantedWithMods = 1	psGrantedWithMods	when the PKIStatus contains the value one a TimeStampToken, with modifications, is present.
psRejection = 2	psRejection	request is rejected
psWaiting = 3	psWaiting	request is postponed
psRevocationWarning = 4	psRevocationWarning	this message contains a warning that a revocation is imminent
psRevocationNotification = 5	psRevocationNotification	notification that a revocation has occurred
psKeyUpdateWarning = 6	psKeyUpdateWarning	key update warning

FailureInfo possible values:

[.NET] [Pascal]	[C++]	Description
tfiBadAlg = 0	SB_tfiBadAlg = 0	Unknown or unsupported algorithm
tfiBadRequest = 2	SB_tfiBadRequest = 2	Transaction not permitted or supported
tfiBadDataFormat = 5	SB_tfiBadDataFormat = 5	Request data format is not supported
tfiTimeNotAvailable = 14	SB_tfiTimeNotAvailable = 14	Time is not available
tfiUnacceptedPolicy = 15	SB_tfiUnacceptedPolicy = 15	TSA's policy does not correspond to ReqPolicy of the request
tfiUnacceptedExtension = 16	SB_tfiUnacceptedExtension = 16	Extension is not supported
tfiAddInfoNotAvailable = 17	SB_tfiAddInfoNotAvailable = 17	Additional info is not available
tfiSystemFailure = 25	SB_tfiSystemFailure = 25	System failure

Return value

TSP error code.

TSP error code values:

Definition	Value	Description
SB_TSP_ERROR_ABORTED	83969 (0x14801)	Operation aborted
SB_TSP_ERROR_NO_REPLY	83970 (0x14802)	No reply from server
SB_TSP_ERROR_NO_PARAMETERS	83971 (0x14803)	No parameters
SB_TSP_ERROR_NO_CERTIFICATES	83972 (0x14804)	No certificates
SB_TSP_ERROR_WRONG_DATA	83973 (0x14805)	Invalid response data
SB_TSP_ERROR_WRONG_IMPRINT	83974 (0x14806)	Wrong message imprint
SB_TSP_ERROR_WRONG_NONCE	83975 (0x14807)	Wrong nonce from server
SB_TSP_ERROR_UNEXPECTED_CERTIFICATES	83976 (0x14808)	Unexpected certificates
SB_TSP_ERROR_UNRECOGNIZED_FORMAT	81921 (0x14001)	Unrecognized format
SB_TSP_ERROR_DATA_TOO_LONG	81922 (0x14002)	Invalid too long data
SB_TSP_ERROR_UNSUPPORTED_REPLY	81923 (0x14003)	Unsupported reply
SB_TSP_ERROR_GENERAL_ERROR	81924 (0x14004)	General error
SB_TSP_ERROR_REQUEST_REJECTED	81925 (0x14005)	Rejected request

Description

Use this method to perform TSP request. HashedData value size should be equal to the regular size, produced by HashAlgorithm. Reply CMS can be parsed with TSPInfo.ParseCMS method.

Discuss this help topic in SecureBlackbox Forum