Message.DigitalSignature Eigenschaft

  • Referenz

Definition

Namespace:
System.Messaging
Assembly:
System.Messaging.dll

Ruft die digitale Signatur ab, mit der Message Queuing die Meldung authentifiziert, oder legt diese fest.

public:
 property cli::array <System::Byte> ^ DigitalSignature { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgDigitalSignature")]
public byte[] DigitalSignature { get; set; }
[<System.Messaging.MessagingDescription("MsgDigitalSignature")>]
member this.DigitalSignature : byte[] with get, set
Public Property DigitalSignature As Byte()

Eigenschaftswert

Byte[]

Ein Bytearray, das die zur Authentifizierung der Meldung verwendete digitale Signatur von Message Queuing 1.0 enthält. Der Standardwert ist ein Array der Länge 0.

Attribute
MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

Die DigitalSignature-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

ArgumentException

Die DigitalSignature-Eigenschaft ist null.

Hinweise

Message Queuing verwendet die digitale Signatur bei der Authentifizierung von Nachrichten, die von Message Queuing Version 1.0 gesendet wurden. In den meisten Fällen generiert und legt Message Queuing die DigitalSignature -Eigenschaft fest, wenn die sendende Anwendung eine Authentifizierung anfordert. Die empfangende Anwendung verwendet diese Eigenschaft, um die an die Nachricht angefügte digitale Signatur abzurufen.

Sie können die DigitalSignature -Eigenschaft nur verwenden, wenn Sie Message Queuing Version 2.0 ausführen. Die sendende Anwendung muss Beim Anfordern der Authentifizierung Signaturen der Version 1.0 von Message Queuing angeben. Wenn die sendende Anwendung eine Message Queuing-Signatur der Version 2.0 sendet, enthält diese Eigenschaft einen Puffer von vier Bytes, die jeweils null enthalten.

Die DigitalSignature -Eigenschaft wird zusammen mit der SenderCertificate -Eigenschaft auch von Connectoranwendungen verwendet, wenn eine Nachricht gesendet wird. In diesem Szenario generiert die Connectoranwendung anstelle von Message Queuing die digitale Signatur, die auf dem Zertifikat des Benutzers basiert, der die Nachricht sendet.

Die DigitalSignature Eigenschaft hat eine maximale Arraygröße von 256.

Wenn Sie die DigitalSignature -Eigenschaft festlegen, müssen Sie auch die ConnectorType -Eigenschaft festlegen. Wenn eine Nachricht gesendet wird, ignoriert Message Queuing die DigitalSignature -Eigenschaft, wenn die ConnectorType Eigenschaft nicht ebenfalls festgelegt ist.

Gilt für:

Weitere Informationen