verify

Verifica la validità di una firma.

Sintassi

Reference_Syntax.verify( OBJECT param1 [, BOOLEAN param2 [, OBJECT param3 [, OBJECT param4 ] ] ] )

Parametri

param1	input	Un nodo di firma XML valido.
param2 (facoltativo)	input (facoltativo)	`true \| 1` (JavaScript) o `1` (FormCalc) (predefinito) Indica che l'operazione specificata prevede l'utilizzo di una finestra di dialogo. `false \| 0` (JavaScript) o `0` (FormCalc) Indica che l'operazione specificata non prevede l'utilizzo di alcuna finestra di dialogo.
param3 (facoltativo)	input (facoltativo)	L'oggetto SecurityHandler utilizzato per la firma. Gli oggetti di protezione in genere richiedono l'inizializzazione prima di poter essere utilizzati per la firma.
param4 (facoltativo)	output (facoltativo)	Un oggetto SignatureInfo di output contenente le proprietà scrivibili della firma.

Valore restituito

Un numero intero che rappresenta la validità della firma oppure un'eccezione, se il nodo non è un nodo di firma. La tabella seguente descrive i valori di validità:

Valore	Descrizione
0	La firma è vuota.
1	Stato sconosciuto. In questo caso, non è stato effettuato alcun tentativo di convalidare la firma. Il problema può essere dovuto a un errore hardware o software che impedisce l'esecuzione della convalida.
2	Firma non valida.
3	La firma è valida, ma non è stato possibile verificare l'identità del firmatario.
4	La firma e l'identità del firmatario sono valide.

Si applica a

Modello	Oggetto
Modello Firma	signaturePseudoModel

Versione

XFA 2.1

Esempi

JavaScript

//This example examines the validity of all signed objects on a form. For 
//each signed object, the integer return value of the verify() method 
// displays in a message box. 
var oSigs = xfa.signature.enumerate(); 
var iNum = oSigs.length; 
for (var i=0; i < iNum; i++)  
{ 
    var oChild = oSigs.item(i); 
    var iVerify = xfa.signature.signer(child); 
    xfa.host.messageBox(iVerify); 
}

FormCalc

//This example examines the validity of all signed objects on a form. For 
//each signed object, the integer return value of the verify() method 
// displays in a message box. 
var oSigs = xfa.signature.enumerate() 
var iNum = oSigs.length - 1 
for i=0 upto iNum step 1 do 
    var oChild = oSigs.item(i) 
    var iVerify = xfa.signature.signer(child) 
    xfa.host.messageBox(iVerify) 
endfor