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

Artigo
08/25/2023

Obtém o método de assinatura usado para calcular o valor no elemento SignatureValue da marcação de assinatura.

Sintaxe

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

Parâmetros

[out, retval] signatureMethod

Um ponteiro para o método de assinatura.

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	O parâmetro signatureMethod é NULL.

Comentários

Esse método aloca memória usada pela cadeia de caracteres retornada em signatureMethod. Se o método for bem-sucedido, chame a função CoTaskMemFree para liberar a memória.

Para definir o método de assinatura antes que a assinatura seja gerada, chame o método IOpcSigningOptions::SetSignatureMethod .

Para acessar o método de assinatura antes que a assinatura seja gerada, chame IOpcSigningOptions::GetSignatureMethod. Para acessar o método de assinatura depois que a assinatura for gerada, chame o método IOpcDigitalSignature::GetSignatureMethod . Ambos os métodos recuperam o valor que foi definido por IOpcSigningOptions::SetSignatureMethod.

Importante Um método de assinatura válido deve ser definido antes que a assinatura seja gerada chamando o método IOpcDigitalSignatureManager::Sign .

Quando uma assinatura é gerada, ela é serializada como marcação de assinatura. O método signature é usado para calcular o valor no elemento SignatureValue na marcação de assinatura.

Quando uma assinatura é validada, o método de assinatura é usado para recalcular esse valor e o valor recalculado é comparado ao valor no elemento SignatureValue na marcação de assinatura.

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