Freigeben über


Message.DigitalSignature Eigenschaft

Definition

Ruft die digitale Signatur ab, die Message Queuing zum Authentifizieren der Nachricht verwendet, oder legt sie 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 Array von Bytewerten, das die digitale Signatur "Message Queuing 1.0" angibt, die zum Authentifizieren der Nachricht verwendet wird. Der Standardwert ist ein Array der Länge Null.

Attribute

Ausnahmen

Die Nachrichtenwarteschlange wird gefiltert, um die DigitalSignature Eigenschaft zu ignorieren.

Die DigitalSignature Eigenschaft ist null.

Hinweise

Message Queuing verwendet die digitale Signatur beim Authentifizieren 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 die 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 Message Queuing Version 1.0-Signaturen angeben. Wenn die sendende Anwendung eine Message Queuing Version 2.0-Signatur 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