IOpcDigitalSignature::GetSignatureMethod method (msopc.h)

Artikel
03/05/2024

Mendapatkan metode tanda tangan yang digunakan untuk menghitung nilai dalam elemen SignatureValue dari markup tanda tangan.

Sintaks

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

Parameter

[out, retval] signatureMethod

Penunjuk ke metode tanda tangan.

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 sebelum tanda tangan dibuat, 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 . Kedua metode mengambil nilai yang ditetapkan oleh IOpcSigningOptions::SetSignatureMethod.

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