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, 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
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
Ausnahmen
Die DigitalSignature-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.
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.