Metodo IOpcDigitalSignature::GetSignatureValue (msopc.h)

Articolo
03/05/2024

Ottiene il valore decodificato nell'elemento SignatureValue del markup della firma.

Sintassi

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

Parametri

[out] signatureValue

Puntatore a un buffer contenente il valore decodificato nell'elemento SignatureValue del markup della firma.

[out] count

Dimensione del buffer signatureHashValue .

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	Almeno uno dei parametri signatureValue e conteggio è NULL.

Commenti

Questo metodo alloca la memoria utilizzata dal buffer restituito in signatureValue. Se il metodo ha esito positivo, chiamare la funzione CoTaskMemFree per liberare la memoria.

L'elemento SignatureValue contiene un valore codificato base-64 calcolato applicando il metodo di firma all'elemento SignedInfo del markup della firma. Per ottenere il metodo signature, chiamare il metodo GetSignatureMethod .

Quando si usano le API per generare una firma, impostare il metodo di firma chiamando il metodo IOpcSigningOptions::SetSignatureMethod .

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