IOpcSigningOptions::GetSignatureMethod method (msopc.h)

Artikel
08/25/2023

Mendapatkan metode tanda tangan yang akan digunakan untuk menghitung dan mengenkripsi nilai hash elemen SignedInfo , yang akan diserialisasikan sebagai elemen SignatureValue dari tanda tangan.

Sintaks

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

Parameter

[out, retval] signatureMethod

Penunjuk ke metode tanda tangan yang akan digunakan, atau string kosong "" jika tidak ada metode yang diatur menggunakan metode SetSignatureMethod .

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	Parameter signatureMethod adalah NULL.

Keterangan

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

Untuk mengatur metode tanda tangan, panggil metode IOpcSigningOptions::SetSignatureMethod .

Untuk mengakses metode tanda tangan sebelum tanda tangan dibuat, panggil IOpcSigningOptions::GetSignatureMethod. Untuk mengakses metode tanda tangan setelah tanda tangan dibuat, panggil metode IOpcDigitalSignature::GetSignatureMethod .

Penting Metode tanda tangan yang valid harus diatur sebelum tanda tangan dihasilkan dengan memanggil metode IOpcDigitalSignatureManager::Sign .

Ketika tanda tangan dihasilkan, tanda tangan diserialisasikan sebagai markup tanda tangan. Metode tanda tangan digunakan untuk menghitung nilai dalam elemen SignatureValue dalam markup tanda tangan.

Ketika tanda tangan divalidasi, metode tanda tangan digunakan untuk menghitung ulang nilai tersebut, dan nilai yang dihitung ulang dibandingkan dengan nilai dalam elemen SignatureValue dalam markup tanda tangan.

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

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