IOpcSignatureCustomObjectSet::Create-Methode (msopc.h)

Artikel
08/25/2023

Erstellt einen IOpcSignatureCustomObject-Schnittstellenzeiger , um ein anwendungsspezifisches Object-Element in der Signatur darzustellen, und fügt die neue Schnittstelle dem Satz hinzu.

Syntax

HRESULT Create(
  [in]          const UINT8               *xmlMarkup,
  [in]          UINT32                    count,
  [out, retval] IOpcSignatureCustomObject **customObject
);

Parameter

[in] xmlMarkup

Ein Puffer, der das XML-Markup für das zu darstellende Object-Element enthält.

Dieses XML-Markup muss die öffnenden Object - und schließenden /Object-Tags enthalten.

Die Codierung des in xmlMarkup enthaltenen Markups wird abgeleitet. Die Aufnahme einer Bytereihenfolgenmarkierung am Anfang des Puffers, der in xmlMarkup übergeben wird, ist optional.

Die folgenden Codierungen und Bytereihenfolgemarkenwerte werden unterstützt:

Codieren	BESCHREIBUNG	Bytereihenfolge-Marke
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, big endian	FE FF

[in] count

Die Größe des xmlMarkup-Puffers .

[out, retval] customObject

Ein neuer IOpcSignatureCustomObject-Schnittstellenzeiger , der das anwendungsspezifische Object-Element darstellt.

Dieser Parameter kann NULL sein, wenn kein Zeiger auf die neue Schnittstelle erforderlich ist.

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 count-Parameter ist 0. Der xmlMarkup-Parameter muss als gültiges XML-Markup übergeben werden.
E_POINTER	Der xmlMarkup-Parameter ist NULL.

Hinweise

Ein IOpcSignatureCustomObject-Schnittstellenzeiger ermöglicht den Zugriff auf das XML-Markup des von ihr dargestellten Object-Elements . Um auf das XML-Markup des Object-Elements zuzugreifen, rufen Sie die IOpcSignatureCustomObject::GetXml-Methode auf.

Wenn ein IOpcSignatureCustomObject-Schnittstellenzeiger erstellt und dem Satz hinzugefügt wird, wird das objekt, das er darstellt, beim Speichern des Pakets gespeichert.

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