Metode IOpcDigitalSignature::GetSignatureValue (msopc.h)

Artikel
08/25/2023

Mendapatkan nilai yang didekodekan dalam elemen SignatureValue dari markup tanda tangan.

Sintaks

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

Parameter

[out] signatureValue

Penunjuk ke buffer yang berisi nilai yang didekodekan dalam elemen SignatureValue dari markup tanda tangan.

[out] count

Ukuran buffer signatureHashValue .

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Setidaknya salah satu parameter signatureValue, dan hitungan adalah NULL.

Keterangan

Metode ini mengalokasikan memori yang digunakan oleh buffer yang dikembalikan dalam signatureValue. Jika metode berhasil, panggil fungsi CoTaskMemFree untuk membebaskan memori.

Elemen SignatureValue berisi nilai yang dikodekan base-64 yang dihitung dengan menerapkan metode tanda tangan ke elemen SignedInfo dari markup tanda tangan. Untuk mendapatkan metode tanda tangan, panggil metode GetSignatureMethod .

Saat menggunakan API untuk menghasilkan tanda tangan, atur metode tanda tangan dengan memanggil metode IOpcSigningOptions::SetSignatureMethod .

Keamanan Thread

Objek pengemasan tidak aman untuk rangkaian.

Untuk informasi selengkapnya, lihat Memulai API Kemasan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h