Método IOpcDigitalSignature::GetSignatureValue (msopc.h)

Artigo
08/25/2023

Obtém o valor decodificado no elemento SignatureValue da marcação de assinatura.

Sintaxe

HRESULT GetSignatureValue(
  [out] UINT8  **signatureValue,
  [out] UINT32 *count
);

Parâmetros

[out] signatureValue

Um ponteiro para um buffer que contém o valor decodificado no elemento SignatureValue da marcação de assinatura.

[out] count

O tamanho do buffer signatureHashValue .

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_POINTER	Pelo menos um dos parâmetros signatureValue e count é NULL.

Comentários

Esse método aloca memória usada pelo buffer retornado em signatureValue. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória.

O elemento SignatureValue contém um valor codificado em base 64 que foi calculado aplicando o método signature ao elemento SignedInfo da marcação de assinatura. Para obter o método de assinatura, chame o método GetSignatureMethod .

Ao usar as APIs para gerar uma assinatura, defina o método de assinatura chamando o método IOpcSigningOptions::SetSignatureMethod .

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