Método IXpsSignatureBlock::CreateRequest (xpsdigitalsignature.h)
Crea una nueva interfaz IXpsSignatureRequest y la agrega al bloque de firma.
Sintaxis
HRESULT CreateRequest(
[in] LPCWSTR requestId,
[out, retval] IXpsSignatureRequest **signatureRequest
);
Parámetros
[in] requestId
Cadena que identifica de forma única la nueva solicitud de firma dentro del bloque de firma. Para que el método genere una cadena de identificador, establezca este parámetro en NULL.
[out, retval] signatureRequest
Puntero a la nueva interfaz IXpsSignatureRequest . Si no se requiere acceso a la nueva interfaz de solicitud, este parámetro se puede establecer en NULL.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener los valores devueltos que no aparecen en esta tabla, vea XpS Digital Signature API Errors and XPS Document Errors (Errores de documentos XPS y XPS).
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
La interfaz no está conectada al administrador de firmas o requestId es NULL y no se pudo generar una cadena de identificador único. |
Comentarios
La nueva solicitud de firma debe tener un identificador de solicitud único; no puede haber dos solicitudes con la misma cadena de identificador.
La creación de una nueva solicitud marca el bloque de firma como sucio y genera nuevo contenido para el elemento SignatureDefinitions. Cuando se serializa el paquete XPS, el nuevo contenido sobrescribirá el contenido anterior en la parte SignatureDefinitions.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | xpsdigitalsignature.h |