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

Artículo
08/25/2023

Obtiene el método de firma que se va a usar para calcular y cifrar el valor hash del elemento SignedInfo , que se serializará como el elemento SignatureValue de la firma.

Sintaxis

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

Parámetros

[out, retval] signatureMethod

Puntero al método de firma que se va a usar o la cadena vacía "" si no se ha establecido ningún método mediante el método SetSignatureMethod .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro signatureMethod es NULL.

Comentarios

Este método asigna memoria usada por la cadena devuelta en signatureMethod. Si el método se ejecuta correctamente, llame a la función CoTaskMemFree para liberar la memoria.

Para establecer el método de firma, llame al método IOpcSigningOptions::SetSignatureMethod .

Para obtener acceso al método de firma antes de generar la firma, llame al método IOpcSigningOptions::GetSignatureMethod. Para acceder al método de firma después de generar la firma, llame al método IOpcDigitalSignature::GetSignatureMethod .

Importante Se debe establecer un método de firma válido antes de que se genere la firma llamando al método IOpcDigitalSignatureManager::Sign .

Cuando se genera una firma, se serializa como marcado de firma. El método signature se usa para calcular el valor del elemento SignatureValue en el marcado de firma.

Cuando se valida una firma, el método signature se usa para recalcular ese valor y el valor recalculado se compara con el valor del elemento SignatureValue en el marcado de firma.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h