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

Artigo
02/29/2024

Cria um ponteiro de interface IOpcSignatureCustomObject para representar um elemento Object específico do aplicativo na assinatura e adiciona a nova interface ao conjunto.

Sintaxe

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

Parâmetros

[in] xmlMarkup

Um buffer que contém a marcação XML para o elemento Object a ser representado.

Essa marcação XML deve incluir as marcas Object de abertura e fechamento /Object .

A codificação da marcação contida em xmlMarkup será inferida. A inclusão de uma marca de ordem de byte no início do buffer passado em xmlMarkup é opcional.

Há suporte para as seguintes codificações e valores de marca de ordem de bytes :

Codificação	Descrição	Marca de ordem de byte
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, little endian	FF FE
UTF16BE	UTF-16, big endian	FE FF

[in] count

O tamanho do buffer xmlMarkup .

[out, retval] customObject

Um novo ponteiro de interface IOpcSignatureCustomObject que representa o elemento Object específico do aplicativo.

Esse parâmetro poderá ser NULL se um ponteiro para a nova interface não for necessário.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O parâmetro count é 0. O parâmetro xmlMarkup deve ser passado marcação XML válida.
E_POINTER	O parâmetro xmlMarkup é NULL.

Comentários

Um ponteiro de interface IOpcSignatureCustomObject fornece acesso à marcação XML do elemento Object que ele representa. Para acessar a marcação XML do elemento Object , chame o método IOpcSignatureCustomObject::GetXml .

Quando um ponteiro de interface IOpcSignatureCustomObject é criado e adicionado ao conjunto, o Objeto que ele representa é salvo quando o pacote é salvo.

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h