XpsDigSigPartAlteringRestrictions Wyliczenie

Definicja

Określa części Package pliku XPS, które są wykluczone z zakresu podpisu cyfrowego.Specifies the parts of the XPS Package that are excluded from the range of a digital signature.

To wyliczenie ma atrybut FlagsAttribute zezwalający na bitową kombinację jego wartości składowych.

public enum class XpsDigSigPartAlteringRestrictions
[System.Flags]
public enum XpsDigSigPartAlteringRestrictions
[<System.Flags>]
type XpsDigSigPartAlteringRestrictions = 
Public Enum XpsDigSigPartAlteringRestrictions
Dziedziczenie
XpsDigSigPartAlteringRestrictions
Atrybuty

Pola

Annotations 2

Część adnotacji jest wykluczona.The Annotations part is excluded.

CoreMetadata 1

Część Core Properties jest wykluczona.The Core Properties part is excluded.

None 0

Żadne części nie są wykluczone.No parts are excluded.

SignatureOrigin 4

Część źródła podpisu jest wykluczona.The Signature Origin part is excluded.

Przykłady

Poniższy przykład pokazuje, jak używać tego wyliczenia do cyfrowego podpisywania dokumentu XPS.The following example shows how to use this enumeration to digitally sign an XPS document.


// ------------------------------ 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

Uwagi

To wyliczenie ma FlagsAttribute, które pozwala na bitowe łączenie wartości jego elementów członkowskich.This enumeration has a FlagsAttribute that allows a bitwise combination of its member values.

Części, które są określone jako wykluczone z podpisu cyfrowego, można modyfikować bez unieważniania podpisu.Parts that are specified as excluded from the digital signature can be modified without invalidating the signature. Jeśli na przykład dokument ma być podpisany przez więcej niż jedną osobę, część SignatureOrigin musi zostać wykluczona z podpisu, gdy dokument jest po raz pierwszy podpisany.For example, if a document is to be signed by more than one person, the SignatureOrigin part needs to be excluded from the signature when the document is first signed. (Wykluczenia są określone w restrictions parametrze wywołania do SignDigitally .) Jeśli część SignatureOrigin nie zostanie wykluczona, wszelkie dodatkowe podpisy unieważnią podpis pierwszej osoby podpisującej.(Exclusions are specified in the restrictions parameter of the call to SignDigitally.) If the SignatureOrigin part is not excluded, any additional signatures invalidate the signature of the first signer.

Aby uzyskać więcej informacji na temat podpisów cyfrowych, zapoznaj się z artykułem cyfrowe podpisywanie pakietów w witrynie MSDN dostępnych pod adresem https://go.microsoft.com/fwlink/?LinkId=74494 .For more information about digital signatures, see the MSDN article Digital Signing Framework of the Open Packaging Conventions available at https://go.microsoft.com/fwlink/?LinkId=74494.

Aby uzyskać więcej informacji na temat podstawowych właściwości i części pierwotnych podpisu, zobacz rozdział 3 specyfikacji opend Conventions dostępnych do pobrania w systemie https://go.microsoft.com/fwlink/?LinkID=71255 .For more information on the Core Properties and Signature Origin parts, see Chapter 3 of the Open Packaging Conventions specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Dotyczy

Zobacz też