XpsDigSigPartAlteringRestrictions Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Parts des XPS Package an, die aus dem Bereich einer digitalen Signatur ausgeschlossen werden.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions =
Public Enum XpsDigSigPartAlteringRestrictions
- Vererbung
- Attribute
Felder
Annotations | 2 | Das Annotations-Part wird ausgeschlossen. |
CoreMetadata | 1 | Das Core Properties-Part wird ausgeschlossen. |
None | 0 | Es werden keine Parts ausgeschlossen. |
SignatureOrigin | 4 | Das Signature Origin-Part wird ausgeschlossen. |
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie diese Aufzählung verwenden, um ein XPS-Dokument digital zu signieren.
// ------------------------------ SignXps -----------------------------
/// <summary>
/// Signs an XPS document with a given X509 certificate, and if one
/// exists, associates the signature with a given SignatureDefintion
/// spotId GUID.</summary>
/// <param name="xpsDocument">
/// The XPS document to sign.</param>
/// <param name="cert">
/// The X509 certificate to use for signing.</param>
/// <param name="spotId">
/// The nullable spotId GUID of the signature definition.</param>
public void SignXps(
XpsDocument xpsDocument, X509Certificate cert, Guid? spotId )
{
// If there's a SignatureDefinition spotId,
// associate it with the signature.
if (spotId != null)
{
xpsDocument.SignDigitally(
cert, true, XpsDigSigPartAlteringRestrictions.None,
spotId.Value);
}
else
{
xpsDocument.SignDigitally(
cert, true, XpsDigSigPartAlteringRestrictions.None);
}
}// end:SignXps()
' ------------------------------ SignXps -----------------------------
''' <summary>
''' Signs an XPS document with a given X509 certificate, and if one
''' exists, associates the signature with a given SignatureDefintion
''' spotId GUID.</summary>
''' <param name="xpsDocument">
''' The XPS document to sign.</param>
''' <param name="cert">
''' The X509 certificate to use for signing.</param>
''' <param name="spotId">
''' The nullable spotId GUID of the signature definition.</param>
Public Sub SignXps(xpsDocument As XpsDocument, cert As X509Certificate, spotId? As Guid)
' If there's a SignatureDefinition spotId,
' associate it with the signature.
If spotId IsNot Nothing Then
xpsDocument.SignDigitally(cert, True, XpsDigSigPartAlteringRestrictions.None, spotId.Value)
Else
xpsDocument.SignDigitally(cert, True, XpsDigSigPartAlteringRestrictions.None)
End If
End Sub
Hinweise
Diese Enumeration verfügt über ein FlagsAttribute, das eine bitzeiger Kombination seiner Memberwerte ermöglicht.
Teile, die von der digitalen Signatur ausgeschlossen sind, können ohne ungültige Signatur geändert werden. Wenn z. B. ein Dokument von mehr als einer Person signiert werden soll, muss der SignatureOrigin-Teil beim ersten Signierten aus der Signatur ausgeschlossen werden. (Ausschlüsse werden im restrictions
Parameter des Aufrufs von SignDigitally.) angegeben. Wenn der SignatureOrigin-Teil nicht ausgeschlossen ist, werden alle zusätzlichen Signaturen die Signatur des ersten Signers ungültig.
Weitere Informationen zu digitalen Signaturen finden Sie unter Digital Sign Framework der Open Packaging-Konventionen.
Weitere Informationen zu den Komponenten "Kerneigenschaften" und "Signature Origin" finden Sie in Kapitel 3 der Spezifikation " Open Packaging Convention ", die zum Download https://www.ecma-international.org/publications-and-standards/standards/ecma-376/zur Verfügung steht.