IOpcDigitalSignatureManager-Schnittstelle (msopc.h)

Artikel
03/04/2024

Ermöglicht den Zugriff auf Packaging Digital Signature Interfaces für ein Paket, das durch Verpackungs-API-Objekte dargestellt wird. Diese Schnittstellenmethoden werden aufgerufen, um eine Signatur zu generieren oder auf vorhandene Signaturen im Paket zuzugreifen und diese zu überprüfen.

Vererbung

Die IOpcDigitalSignatureManager-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcDigitalSignatureManager verfügt auch über die folgenden Membertypen:

Methoden

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


IOpcDigitalSignatureManager::CreateSigningOptions Erstellt einen IOpcSigningOptions-Schnittstellenzeiger.
IOpcDigitalSignatureManager::GetSignatureEnumerator Ruft einen Enumerator von IOpcDigitalSignature-Schnittstellenzeigern ab, die Paketsignaturen darstellen.
IOpcDigitalSignatureManager::GetSignatureOriginPartName Ruft einen IOpcPartUri-Schnittstellenzeiger ab, der den Teilenamen des Digital Signature Origin-Teils darstellt.
IOpcDigitalSignatureManager::RemoveSignature Entfernt aus dem Paket einen angegebenen Signaturteil, in dem Signaturmarkup gespeichert wird.
IOpcDigitalSignatureManager::ReplaceSignatureXml Ersetzt das vorhandene Signaturmarkup, das in einem angegebenen Signaturteil gespeichert ist.
IOpcDigitalSignatureManager::SetSignatureOriginPartName Legt den Teilenamen des Teils "Digital Signature Origin" auf den Namen fest, der durch einen angegebenen IOpcPartUri-Schnittstellenzeiger dargestellt wird.
IOpcDigitalSignatureManager::Sign Signiert das Paket, indem eine Signatur mithilfe des angegebenen Zertifikats und des IOpcSigningOptions-Schnittstellenzeigers generiert wird.
IOpcDigitalSignatureManager::Validate Überprüft eine angegebene Paketsignatur mithilfe eines angegebenen Zertifikats.

Hinweise

Bevor die Sign-Methode zum Generieren einer Signatur aufgerufen wird, müssen die Methoden IOpcSigningOptions::SetDefaultDigestMethod und IOpcSigningOptions::SetSignatureMethod aufgerufen werden.

Um einen IOpcDigitalSignatureManager-Schnittstellenzeiger zu erstellen, rufen Sie die IOpcFactory::CreateDigitalSignatureManager-Methode auf.

Wichtig Wenn das Paket während der Ausführung der Sign-Methode geändert wird, schlägt die Methode möglicherweise fehl oder generiert eine inkonsistente Signatur. Um eine Beschädigung des Pakets zu vermeiden, verwenden Sie die APIs, um das Paket vor dem Aufrufen von Sign zu speichern. Informationen zum Speichern eines Pakets finden Sie unter Speichern eines Pakets.

Die Validate-Methode überprüft, ob die angegebene Signatur (signierte Entitäten und das Signaturmarkup) seit der Generierung der Signatur nicht geändert wurde. Die Identität des Signaturgebers wird jedoch nicht überprüft.

Wichtig Der Aufrufer muss die Identität des Unterzeichners überprüfen.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

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

Anforderungen

Anforderung	Wert
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