IOpcSignaturePartReferenceSet::Create-Methode (msopc.h)

Artikel
02/29/2024

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