Declaration

Delphi

function GetSignedDocHash(var status: Integer; var outLen: Integer): Pointer;

C/C++

SOPAD_API LPVOID SOPAD_GetSignedDocHash(int* status, int* outLen);

ActiveX

HRESULT GetSignedDocHash([out] long* Status, [out, retval] VARIANT* Result);

Description

Function retrieves signed document hash from signature device. Final document hash must be set with the help of function SetFinalDocumentHash.

Arguments

status

Output parameter. Hash calculation status. Status is defined by low 4 bits and high 4 bits. If the pad is not accessible the status is set to value 255 = FFh.

Status bits	Value	Description
Bits 0..3	1	Computations are finished and OK has been pressed
	2	Retry has been pressed
	3	Cancel hash been pressed
	4	Error status, comes from emulation mode, not from device
Bits 4..7	0	Hash calculation is not yet finished by device
Bits 4..7	1	Hash calculation is finished

outLen

Hash size in bytes.

Return value

Function returns pointer to memory block with final hash. In case of failure function returns nil or zero-size array.