IOpcSignaturePartReferenceSet::Create-Methode (msopc.h)

Erstellt einen IOpcSignaturePartReference-Schnittstellenzeiger , der einen Verweis auf ein zu signierende Teil darstellt, und fügt der Gruppe die neue Schnittstelle hinzu.

Syntax

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

Parameter

[in] partUri

Ein IOpcPartUri , der den Teilenamen des zu referenzierten Teils darstellt.

[in] digestMethod

Die Digestmethode, die für den Teilinhalt des zu referenzierten Teils verwendet werden soll. Um die Standard-Digestmethode zu verwenden, übergeben Sie NULL an diesen Parameter.

Wichtig Die Standard-Digestmethode muss durch Aufrufen der IOpcSigningOptions::SetDefaultDigestMethod-Methode festgelegt werden, bevor IOpcDigitalSignatureManager::Sign aufgerufen wird.

 

[in] transformMethod

Die Kanonisierungsmethode, die für den Teilinhalt des zu referenzierten Teils verwendet wird.

[out, retval] partReference

Ein neuer IOpcSignaturePartReference-Schnittstellenzeiger , der den Verweis auf das zu signierende Teil darstellt.

Dieser Parameter kann NULL sein, wenn kein Zeiger auf die neue Schnittstelle benötigt wird.

Rückgabewert

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

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG
Der im parameter transformMethod übergebene Wert ist kein gültiger OPC_CANONICALIZATION_METHOD Enumerationswert.
E_POINTER
Der partUri-Parameter ist NULL.

Hinweise

Nur Teile, die von der IOpcPart-Schnittstelle dargestellt werden können, können mit einem IOpcSignaturePartReference-Schnittstellenzeiger referenziert werden. Auf Beziehungsteile wird zum Signieren durch einen Zeiger auf die IOpcSignatureRelationshipReference-Schnittstelle verwiesen. Um einen IOpcSignatureRelationshipReference-Schnittstellenzeiger zu erstellen, rufen Sie die IOpcSignatureRelationshipReferenceSet::Create-Methode auf.

Wenn ein IOpcSignaturePartReference-Schnittstellenzeiger erstellt und dem Satz hinzugefügt wird, wird der Verweis, den er darstellt, beim Speichern des Pakets gespeichert.

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

Weitere Informationen

Kernpaketschnittstellen

Erste Schritte mit der Verpackungs-API

IOpcDigitalSignatureManager

IOpcSignaturePartReferenceSet

IOpcSignatureRelationshipReferenceSet

IOpcSigningOptions

OPC_CANONICALIZATION_METHOD

Übersichten

Programmierhandbuch zur Paketerstellungs-API

Verpackungs-API-Referenz

Beispiele für die Paket-API

Verpacken von Schnittstellen für digitale Signaturen

Verpackungsschnittstellen

Referenz