PFN_AUTHENTICODE_DIGEST_SIGN_WITHFILEHANDLE fungsi panggilan balik

2023-06-13

Fungsi panggilan balik yang disediakan pengguna PFN_AUTHENTICODE_DIGST_SIGN_WITHFILEHANDLE menerapkan penandatanganan hash. Anda harus menerapkan fungsi ini sebagai bagian dari dll yang Anda sediakan. Fungsi ini saat ini dipanggil oleh SignerSignEx3 untuk penandatanganan hash.

Sintaks

PFN_AUTHENTICODE_DIGEST_SIGN_WITHFILEHANDLE pfnAuthenticodeDigestSignWithFileHandle;

HRESULT __stdcall pfnAuthenticodeDigestSignWithFileHandle(
    _In_ PCCERT_CONTEXT pSigningCert,                        
    _In_opt_ PCRYPT_DATA_BLOB pMetadataBlob,                 
    _In_ ALG_ID digestAlgId,                                 
    _In_ PBYTE pbToBeSignedDigest, 
    _In_ DWORD cbToBeSignedDigest,    
    _In_ HANDLE hFile,                   
    _Out_ PCRYPT_DATA_BLOB pSignedDigest                     
);
                     
);

Parameter

pSigningCert [in]: Penunjuk ke struktur CERT_CONTEXT yang menentukan sertifikat yang digunakan untuk membuat tanda tangan digital.
pMetadataBlob [in, opsional]: Penunjuk ke struktur CRYPT_DATA_BLOB yang berisi metadata untuk penandatanganan hash.
digestAlgId [in]: Menentukan algoritma hash yang akan digunakan untuk penandatanganan hash.
pbToBeSignedDigest [in]: Penunjuk ke buffer yang berisi hash yang akan ditandatangani.
cbToBeSignedDigest [in]: Ukuran, dalam byte, dari buffer pbToBeSignedDigest.
hFile [in]: Tangani ke file yang sedang ditandatangani.
pSignedDigest [out]: Penunjuk ke CRYPT_DATA_BLOB yang menerima hash yang ditandatangani.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Parameter pSignedDigest-pbData> harus dialokasikan dengan memanggil HeapAlloc melewati hasil GetProcessHeap() sebagai parameter pertama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11 [khusus aplikasi desktop]
DLL	Mssign32.dll