verify

Verifica la validez de una firma.

Sintaxis

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

Parámetros

param1

input

Un nodo de firma XML válida.

param2 (opcional)

input (opcional)

  • true | 1 (JavaScript) o 1 (FormCalc) (predeterminado)

  • Indica que se utiliza un cuadro de diálogo para esta operación.

  • false | 0 (JavaScript) o 0 (FormCalc)

  • Indica que no se utiliza un cuadro de diálogo para esta operación.

param3 (opcional)

input (opcional)

El objeto SecurityHandler que se utiliza para firmar. Los objetos de seguridad suelen requerir su inicialización antes de poder utilizarlos para firmar.

param4 (opcional)

output (opcional)

Un objeto de salida SignatureInfo que contiene las propiedades de la firma que admiten escritura.

Devuelve

Un entero que representa la validez de la firma o una excepción si el nodo no es un nodo de firma. En la tabla siguiente se describen los valores de validez:

Value

Descripción

0

La firma está vacía.

1

Estado desconocido. En este caso, no se realizó ningún intento para validar la firma. Una posible causa podría ser un fallo de software o hardware que evite que se produzca la validación.

2

La firma no es válida.

3

La firma es válida, pero no se ha podido verificar la identidad de la persona que lo ha firmado.

4

La firma es válida y la identidad de la persona que lo ha firmado también es válida.

Aplicable a

Versión

XFA 2,1

Ejemplos

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