Metodo IOpcDigitalSignature::GetSignatureMethod (msopc.h)

Articolo
03/05/2024

Ottiene il metodo di firma usato per calcolare il valore nell'elemento SignatureValue del markup della firma.

Sintassi

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

Parametri

[out, retval] signatureMethod

Puntatore al metodo di firma.

Valore restituito

Il metodo restituisce un 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

Questo metodo alloca la memoria utilizzata dalla stringa restituita in signatureMethod. Se il metodo ha esito positivo, chiamare la funzione CoTaskMemFree per liberare la memoria.

Per impostare il metodo di firma prima della generazione della firma, chiamare il metodo IOpcSigningOptions::SetSignatureMethod .

Per accedere al metodo di firma prima che venga generata la firma, chiamare IOpcSigningOptions::GetSignatureMethod. Per accedere al metodo di firma dopo la generazione della firma, chiamare il metodo IOpcDigitalSignature::GetSignatureMethod . Entrambi i metodi recuperano il valore impostato da IOpcSigningOptions::SetSignatureMethod.

Importante Un metodo di firma valido deve essere impostato prima che la firma venga generata chiamando il metodo IOpcDigitalSignatureManager::Sign .

Quando viene generata una firma, viene serializzata come markup di firma. Il metodo di firma viene usato 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

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione 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