IOpcSignatureReferenceSet::Create-Methode (msopc.h)

Artikel
08/25/2023

Erstellt einen IOpcSignatureReference-Schnittstellenzeiger , der einen Verweis auf ein zu signiertes XML-Element darstellt.

Syntax

HRESULT Create(
  [in]          IUri                        *referenceUri,
  [in]          LPCWSTR                     referenceId,
  [in]          LPCWSTR                     type,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignatureReference      **reference
);

Parameter

[in] referenceUri

Der URI des XML-Elements, auf das verwiesen wird.

Legen Sie den Wert dieses Parameters auf einen URI fest, der "#" darstellt, gefolgt vom Id-Attributwert des Elements, auf das verwiesen wird: "#<elementIdValue>".

Beispiele finden Sie im Abschnitt Hinweise.

[in] referenceId

Das Id-Attribut des Reference-Elements , das den Verweis im Signaturmarkup darstellt. Wenn Sie das Id-Attribut weglassen möchten, legen Sie diesen Parameterwert auf NULL fest.

[in] type

Das Type-Attribut des Reference-Elements , das den Verweis im Signaturmarkup darstellt. Um das Type-Attribut wegzulassen, legen Sie diesen Parameterwert auf NULL fest.

[in] digestMethod

Die Digestmethode, die für das XML-Markup verwendet werden soll, auf das verwiesen werden soll. Um die Standard-Digestmethode zu verwenden, legen Sie diesen Parameterwert auf NULL fest.

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 das XML-Markup verwendet werden soll, auf das verwiesen werden soll.

[out, retval] reference

Ein neuer IOpcSignatureReference-Schnittstellenzeiger , der den Verweis auf das zu signierte XML-Element darstellt.

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_INVALIDARG	Der im parameter transformMethod übergebene Wert ist kein gültiger OPC_CANONICALIZATION_METHOD Enumerationswert.
E_POINTER	Der referenceUri-Parameter ist NULL.
OPC_E_DS_PACKAGE_REFERENCE_URI_RESERVED 0x80510025	Der reservierte URI-Attributwert des Reference-Elements der Signatur für das Paket Object wird als URI-Attributwert eines Verweises auf ein benutzerdefiniertes Object-Element verwendet.

Hinweise

Diese Methode erstellt einen Verweis auf ein XML-Element, das beim Generieren der Signatur signiert wird. Das Element, auf das verwiesen wird, kann entweder ein anwendungsspezifisches Object-Element oder ein untergeordnetes Element eines anwendungsspezifischen Objekts sein.

Um auf ein XML-Element für die Signatur zu verweisen, legen Sie den referenceUri-Parameterwert auf einen URI fest, der "#" darstellt, gefolgt vom Id-Attributwert des Elements, auf das verwiesen wird, wie in der folgenden Tabelle gezeigt.

referenceUri Wert als Zeichenfolge	Element, auf das verwiesen wird	Elementbeschreibung
"#idMyCustomObject"	"<Object ID="idMyCustomObject">...</Object>"	Ein anwendungsspezifisches Object-Element .
"#idMyElement"	"<Object><MyElement Id="idMyElement">...</MyElement>...</Object>"	Ein untergeordnetes Element eines anwendungsspezifischen Objekts.

Diese Methode erstellt keinen Verweis auf das paketspezifische Object-Element , das signiert werden soll. dieser Verweis wird automatisch erstellt, wenn die Signatur generiert wird.

Wenn ein IOpcSignatureReference-Schnittstellenzeiger erstellt und dem Satz hinzugefügt wird, wird der verweis gespeichert, den er darstellt, wenn das Paket gespeichert wird.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-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