Método IOpcSignatureCustomObjectSet::Create (msopc.h)

Artículo
02/29/2024

Crea un puntero de interfaz IOpcSignatureCustomObject para representar un elemento Object específico de la aplicación en la firma y agrega la nueva interfaz al conjunto.

Sintaxis

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

Parámetros

[in] xmlMarkup

Búfer que contiene el marcado XML para el elemento Object que se va a representar.

Este marcado XML debe incluir las etiquetas /Object de apertura y cierre.

Se deducirá la codificación del marcado contenido en xmlMarkup . La inclusión de una marca de orden de bytes al principio del búfer pasado en xmlMarkup es opcional.

Se admiten las siguientes codificaciones y valores de marca de orden de bytes :

Encoding	Descripción	Marca de orden de bytes
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, big endian	FE FF

[in] count

Tamaño del búfer xmlMarkup .

[out, retval] customObject

Nuevo puntero de interfaz IOpcSignatureCustomObject que representa el elemento Object específico de la aplicación.

Este parámetro puede ser NULL si no se necesita un puntero a la nueva interfaz.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El parámetro count es 0. El parámetro xmlMarkup debe pasar un marcado XML válido.
E_POINTER	El parámetro xmlMarkup es NULL.

Comentarios

Un puntero de interfaz IOpcSignatureCustomObject proporciona acceso al marcado XML del elemento Object que representa. Para obtener acceso al marcado XML del elemento Object , llame al método IOpcSignatureCustomObject::GetXml .

Cuando se crea un puntero de interfaz IOpcSignatureCustomObject y se agrega al conjunto, el objeto que representa se guarda cuando se guarda el paquete.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h