Metodo IOpcSignatureCustomObjectSet::Create (msopc.h)

Articolo
03/05/2024

Crea un puntatore all'interfaccia IOpcSignatureCustomObject per rappresentare un elemento Object specifico dell'applicazione nella firma e aggiunge la nuova interfaccia al set.

Sintassi

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

Parametri

[in] xmlMarkup

Buffer contenente il markup XML per l'elemento Object da rappresentare.

Questo markup XML deve includere i tag /Object di apertura e chiusura di .Object .

Verrà dedotta la codifica del markup contenuto in xmlMarkup . L'inclusione di un contrassegno di ordine di byte all'inizio del buffer passato in xmlMarkup è facoltativo.

Sono supportate le codifiche e i valori di contrassegno dell'ordine dei byte seguenti:

Codifica	Descrizione	Indicatore dell'ordine dei byte
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, big endian	FE FF

[in] count

Dimensioni del buffer xmlMarkup .

[out, retval] customObject

Nuovo puntatore all'interfaccia IOpcSignatureCustomObject che rappresenta l'elemento Object specifico dell'applicazione.

Questo parametro può essere NULL se non è necessario un puntatore alla nuova interfaccia.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro count è 0. Il parametro xmlMarkup deve essere passato a markup XML valido.
E_POINTER	Il parametro xmlMarkup è NULL.

Commenti

Un puntatore all'interfaccia IOpcSignatureCustomObject consente di accedere al markup XML dell'elemento Object rappresentato. Per accedere al markup XML dell'elemento Object , chiamare il metodo IOpcSignatureCustomObject::GetXml .

Quando viene creato un puntatore all'interfaccia IOpcSignatureCustomObject e aggiunto al set, l'oggetto che rappresenta viene salvato quando il pacchetto viene salvato.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h