Message.DigitalSignature Eigenschaft
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.
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
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.