XPS_SIGNATURE_STATUS enumeration
Describes the status of a document's digital signature.
Syntax
typedef enum {
XPS_SIGNATURE_STATUS_INCOMPLIANT = 1,
XPS_SIGNATURE_STATUS_INCOMPLETE = 2,
XPS_SIGNATURE_STATUS_BROKEN = 3,
XPS_SIGNATURE_STATUS_QUESTIONABLE = 4,
XPS_SIGNATURE_STATUS_VALID = 5
} XPS_SIGNATURE_STATUS;
Constants
XPS_SIGNATURE_STATUS_INCOMPLIANT
The signature violates one or more signing rules stated in section 10.2.1.2 of the XML Paper Specification. These rules describe the parts or relationships that must or must not be signed.A signature that is incompliant must be created as such. Changing signed content cannot make a valid signature incompliant. One example of an incompliant signature is the signature of a package that has an unknown relationships type at the root.
XPS_SIGNATURE_STATUS_INCOMPLETE
The signature does not include parts that must be signed.If a valid XPS signature is created and the XPS document contents are later modified, the signature will become incomplete or broken. For example, removing a page from a FixedDocument makes the signature incomplete; it also breaks the signature, but the fact that the signature is incomplete is of greater importance.
XPS_SIGNATURE_STATUS_BROKEN
This is a compliant digital signature, but it fails the signature validation routines described in the Open Packaging Conventions (refer to See Also).Modification of the markup in a FixedPage that has been signed breaks the signature.
XPS_SIGNATURE_STATUS_QUESTIONABLE
This is not an incompliant or broken digital signature, but the signed content (parts and relationships) includes elements or attributes from an unknown namespace introduced through the markup compatibility mechanisms.XPS_SIGNATURE_STATUS_VALID
This is a valid signature: it is not broken, incompliant, or questionable. The application, however, must still check the certificate trust chain, revocation lists, and expiration dates.
Remarks
The digital signature status values correspond to section 10.2.1.2 in the XML Paper Specification.
The Open Packaging Conventions are specified in the 1st edition, Part 2, "Open Packaging Conventions," of Standard ECMA-376, Office Open XML File Formats.
Note These resources may not be available in some languages and countries.
Requirements
Minimum supported client |
Windows 7 [desktop apps only] |
Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
Header |
Xpsdigitalsignature.h |
IDL |
XpsDigitalSignature.idl |