IOpcDigitalSignatureManager-Schnittstelle (msopc.h)

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

Weitere Informationen

Kernverpackungsschnittstellen

Übersicht über digitale Signaturen

Erste Schritte mit der Verpackungs-API

IOpcDigitalSignatureEnumerator

IOpcFactory

Übersichten

Programmierhandbuch für die Paket-API

Verpackungs-API-Referenz

Beispiele für die Paket-API

Packen von Schnittstellen für digitale Signatur

Verpackungsschnittstellen

Referenz