IOpcFactory::CreateDigitalSignatureManager-Methode (msopc.h)

Artikel
11/11/2023

Erstellt ein Digitales Signatur-Manager-Objekt für ein Paketobjekt.

Syntax

HRESULT CreateDigitalSignatureManager(
  [in]          IOpcPackage                 *package,
  [out, retval] IOpcDigitalSignatureManager **signatureManager
);

Parameter

[in] package

Ein Zeiger auf die IOpcPackage-Schnittstelle des Paketobjekts, das dem Digital Signature Manager-Objekt zugeordnet werden soll.

[out, retval] signatureManager

Ein Zeiger auf die IOpcDigitalSignatureManager-Schnittstelle des Digital Signature Manager-Objekts, das für die Verwendung mit dem Paketobjekt erstellt wird.

Ein Digital Signature Manager-Objekt bietet Zugriff auf die Schnittstellen und Methoden für digitale Signaturen der Paketerstellungs-API. Diese können verwendet werden, um das durch das Paketobjekt dargestellte Paket zu signieren oder die Signaturen in einem bereits signierten Paket zu überprüfen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_NOTIMPL	Diese Methode ist für diese Version von Windows nicht implementiert.
OPC_E_DS_DUPLICATE_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001B	Es ist mehr als eine Beziehung des Beziehungstyps des digitalen Signaturursprungs vorhanden, aber nur eine solche Beziehung ist zulässig. Weitere Informationen zu diesem Beziehungstyp finden Sie unter OPC.
OPC_E_DS_INVALID_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001C	Eine Paketbeziehung vom Typ "Digitale Signaturursprung" zielt auf einen Speicherort ab, der sich außerhalb des Pakets befindet. Teile des Digitalen Signaturursprungs müssen intern gefunden werden. Weitere Informationen zu diesem Beziehungstyp finden Sie unter OPC.
OPC_E_DS_MISSING_SIGNATURE_ORIGIN_PART 0x8051001F	Es wurde eine Beziehung vom Typ "Digitaler Signaturursprung" gefunden, der Teil "Digital Signature Origin" selbst jedoch nicht. Weitere Informationen zu diesem Beziehungstyp finden Sie unter OPC.

Hinweise

Wenn ein Paket geändert wird, während das Packen digitaler Signaturschnittstellen zum Signieren des Pakets verwendet wird, kann die Signatur fehlschlagen oder zu einer inkonsistenten Signatur oder zu einem inkonsistenten Paket führen.

Unterstützung für frühere Versionen von Windows

Diese Methode wird in Windows-Versionen vor Windows 7 nicht unterstützt. Weitere Informationen finden Sie unter Erste Schritte mit der Paketerstellungs-API und Plattformupdate für Windows Vista.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h