Método IXpsSignature::SetSignatureXml (xpsdigitalsignature.h)

Artigo
12/22/2023

Define a marcação XML da assinatura digital.

Sintaxe

HRESULT SetSignatureXml(
  [in] const UINT8 *signatureXml,
  [in] UINT32      count
);

Parâmetros

[in] signatureXml

A marcação XML da assinatura digital.

[in] count

O tamanho, em bytes, do buffer referenciado por signatureXml.

Retornar valor

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, 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_POINTER	signatureXml é NULL.
E_UNEXPECTED	A interface não está conectada ao gerenciador de assinaturas.

Comentários

Antes de chamar esse método, o aplicativo deve marcar que a marcação de assinatura é válida. Se a marcação de assinatura não for válida, esse método falhará e o conteúdo da parte de assinatura não será alterado.

Aviso

Usar esse método para criar assinaturas digitais pode fazer com que outros métodos dessa interface retornem assinaturas e dados que não são mais válidos.

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