IOpcSigningOptions-Schnittstelle (msopc.h)

Artikel
08/25/2023

Stellt Methoden zum Festlegen und Zugreifen auf Informationen bereit, die zum Generieren einer Signatur erforderlich sind.

Vererbung

Die IOpcSigningOptions-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcSigningOptions verfügt auch über folgende Arten von Membern:

Methoden

Die IOpcSigningOptions-Schnittstelle verfügt über diese Methoden.


IOpcSigningOptions::GetCertificateEmbeddingOption Ruft einen Wert ab, der den Speicherort im Paket des Zertifikats angibt, das für die Signatur verwendet werden soll.
IOpcSigningOptions::GetCertificateSet Ruft einen IOpcCertificateSet-Schnittstellenzeiger ab.
IOpcSigningOptions::GetCustomObjectSet Ruft eine IOpcSignatureCustomObjectSet-Schnittstelle ab.
IOpcSigningOptions::GetCustomReferenceSet Ruft einen IOpcSignatureReferenceSet-Schnittstellenzeiger ab.
IOpcSigningOptions::GetDefaultDigestMethod Ruft die Standard-Digestmethode ab, die zum Berechnen von Digestwerten für zu signierte Objekte verwendet wird.
IOpcSigningOptions::GetSignatureId Ruft den Wert des Id-Attributs aus dem Signature-Element ab.
IOpcSigningOptions::GetSignatureMethod Ruft die Signaturmethode ab, die zum Berechnen und Verschlüsseln des Hashwerts des SignedInfo-Elements verwendet werden soll, das als SignatureValue-Element der Signatur serialisiert wird.
IOpcSigningOptions::GetSignaturePartName Ruft den Teilenamen des Signaturteils ab, in dem das Signaturmarkup gespeichert wird.
IOpcSigningOptions::GetSignaturePartReferenceSet Ruft eine IOpcSignaturePartReferenceSet-Schnittstelle ab.
IOpcSigningOptions::GetSignatureRelationshipReferenceSet Ruft einen IOpcSignatureRelationshipReferenceSet-Schnittstellenzeiger ab.
IOpcSigningOptions::GetTimeFormat Ruft das Format der Zeichenfolge ab, die von der IOpcDigitalSignature::GetSigningTime-Methode abgerufen wird.
IOpcSigningOptions::SetCertificateEmbeddingOption Legen Sie den Speicherort des Zertifikats fest, das für die Signatur verwendet werden soll.
IOpcSigningOptions::SetDefaultDigestMethod Legt die Standard-Digestmethode fest, die zum Berechnen von Digestwerten für zu signierte Objekte verwendet wird.
IOpcSigningOptions::SetSignatureId Legt den Wert des Id-Attributs des Signature-Elements fest. (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod Legt die Signaturmethode fest, die zum Berechnen und Verschlüsseln des Hashwerts des SignedInfo-Elements verwendet werden soll, das im SignatureValue-Element der Signatur enthalten ist.
IOpcSigningOptions::SetSignaturePartName Legt den Teilenamen des Signaturteils fest, in dem das Signaturmarkup gespeichert wird.
IOpcSigningOptions::SetTimeFormat Legt das Format der Zeichenfolge fest, die von der IOpcDigitalSignature::GetSigningTime-Methode abgerufen wird.

Hinweise

Um eine Signatur zu generieren, rufen Sie die IOpcDigitalSignatureManager::Sign-Methode auf, wobei der wert des parameters signingOptions auf einen IOpcSigningOptions-Schnittstellenzeiger festgelegt ist.

Um einen IOpcSigningOptions-Schnittstellenzeiger zu erstellen, rufen Sie die IOpcDigitalSignatureManager::CreateSigningOptions-Methode auf.

Der Aufrufer muss einen Standardwert für die Digest- und Signaturmethode festlegen, bevor eine Signatur generiert wird. Um eine Standard-Digestmethode festzulegen, rufen Sie die SetDefaultDigestMethod-Methode auf. Um eine Signaturmethode festzulegen, rufen Sie die SetSignatureMethod-Methode auf.

Um einen IOpcSignatureCustomObjectSet-Schnittstellenzeiger abzurufen, rufen Sie die GetCustomObjectSet-Methode auf. Die Schnittstellenzeiger im Satz stellen anwendungsspezifische Object-Elemente dar.

Um einen IOpcSignatureReferenceSet-Schnittstellenzeiger abzurufen, rufen Sie die GetCustomReferenceSet-Methode auf. Die Schnittstellenzeiger im Satz stellen Verweise auf anwendungsspezifische Object-Elemente oder deren untergeordnete Elemente dar, die beim Generieren der Signatur signiert werden.

Der Standardspeicherort des Zertifikats ist OPC_CERTIFICATE_IN_CERTIFICATE_PART. Um diesen Wert zu ändern, rufen Sie die SetCertificateEmbeddingOption-Methode auf.

Das Standardformat der Signaturzeitzeichenfolge ist OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS. Um das Format der Signaturzeitzeichenfolge zu ändern, rufen Sie die SetTimeFormat-Methode auf.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h