Método IXpsSignatureManager::AddSignatureBlock (xpsdigitalsignature.h)

Artigo
03/05/2024

Cria uma nova interface IXpsSignatureBlock e a adiciona à coleção de blocos de assinatura.

Sintaxe

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

Parâmetros

[in] partName

Um ponteiro para a interface IOpcPartUri que contém o URI da nova parte. Para que o método gere um nome de parte, esse parâmetro pode ser definido como NULL.

[in] fixedDocumentIndex

O valor de índice da parte FixedDocument à qual o novo bloco de assinatura deve ser associado.

[out, retval] signatureBlock

Um ponteiro para a nova interface IXpsSignatureBlock . Se o acesso à nova interface não for necessário, esse parâmetro poderá ser definido como NULL.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter valores retornados que não estão listados nesta tabela, consulte Erros de API de Assinatura Digital XPS e Erros de Documento XPS.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	fixedDocumentIndex faz referência a um documento fixo que não foi encontrado no pacote XPS.
XPS_E_PACKAGE_NOT_OPENED	Um pacote XPS ainda não foi aberto no gerenciador de assinaturas.

Comentários

Um bloco de assinatura representa uma parte SignatureDefinitions em um pacote XPS. De acordo com a seção 10.2.2 na Especificação de Papel XML, zero ou mais partes SignatureDefinitions podem ser anexadas a cada FixedDocument. Esse método cria uma nova parte SignatureDefinitions com o nome especificado, vincula-a da parte FixedDocument especificada por uma relação, cria uma nova interface IXpsSignatureBlock e adiciona essa nova interface à coleção de blocos de assinatura interna.

Para recuperar um bloco de assinatura, chame o método GetSignatureBlocks .

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	xpsdigitalsignature.h