Metodo IOpcSigningOptions::SetSignatureMethod (msopc.h)

Articolo
02/29/2024

Imposta il metodo signature da utilizzare per calcolare e crittografare il valore hash dell'elemento SignedInfo , che verrà contenuto nell'elemento SignatureValue della firma.

Sintassi

HRESULT SetSignatureMethod(
  [in] LPCWSTR signatureMethod
);

Parametri

[in] signatureMethod

Metodo di firma da utilizzare.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro signatureMethod è NULL.

Commenti

Per accedere al metodo di firma prima della generazione della firma, chiamare IOpcSigningOptions::GetSignatureMethod. Per accedere al metodo di firma dopo la generazione della firma, chiamare il metodo IOpcDigitalSignature::GetSignatureMethod .

Importante È necessario impostare un metodo di firma valido prima che la firma venga generata chiamando il metodo IOpcDigitalSignatureManager::Sign .

Quando viene generata una firma, viene serializzata come markup della firma. Il metodo signature viene utilizzato per calcolare il valore nell'elemento SignatureValue nel markup della firma.

Quando viene convalidata una firma, il metodo signature viene usato per ricalcolare tale valore e il valore ricalcolato viene confrontato con il valore nell'elemento SignatureValue nel markup della firma.

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h