Fungsi CryptVerifyCertificateSignatureEx (wincrypt.h)
Fungsi CryptVerifyCertificateSignatureEx memverifikasi tanda tangan sertifikat subjek, daftar pencabutan sertifikat, permintaan sertifikat, atau permintaan keygen dengan menggunakan kunci publik penerbit. Fungsi ini tidak memerlukan akses ke kunci privat.
Sintaks
BOOL CryptVerifyCertificateSignatureEx(
[in] HCRYPTPROV_LEGACY hCryptProv,
[in] DWORD dwCertEncodingType,
[in] DWORD dwSubjectType,
[in] void *pvSubject,
[in] DWORD dwIssuerType,
[in] void *pvIssuer,
[in] DWORD dwFlags,
[in, out, optional] void *pvExtra
);
Parameter
[in] hCryptProv
Parameter ini tidak digunakan dan harus diatur ke NULL.
Windows Server 2003 dan Windows XP: Handel ke penyedia layanan kriptografi yang digunakan untuk memverifikasi tanda tangan. Jenis data parameter ini adalah HCRYPTPROV.
NULL diteruskan kecuali ada alasan kuat untuk melewati penyedia kriptografi tertentu. Meneruskan NULL menyebabkan penyedia RSA atau DSS default diperoleh.
[in] dwCertEncodingType
Jenis pengodean sertifikat yang digunakan untuk mengenkripsi subjek. Pengidentifikasi jenis pengodean pesan, yang terkandung dalam WORD tinggi dari nilai ini, diabaikan oleh fungsi ini.
Parameter ini dapat menjadi jenis pengodean sertifikat yang saat ini ditentukan berikut.
| Nilai | Makna |
|---|---|
|
Menentukan pengodean sertifikat X.509. |
[in] dwSubjectType
Jenis subjek. Parameter ini bisa menjadi salah satu jenis subjek berikut.
| Nilai | Makna |
|---|---|
|
pvSubject adalah penunjuk ke struktur CRYPT_DATA_BLOB . |
|
pvSubject adalah penunjuk ke struktur CCERT_CONTEXT . |
|
pvSubject adalah penunjuk ke struktur CCRL_CONTEXT . |
|
pvSubject adalah penunjuk ke struktur OCSP_BASIC_SIGNED_RESPONSE_INFO .
Windows Server 2003 dan Windows XP: Jenis subjek ini tidak didukung. |
[in] pvSubject
Penunjuk ke struktur jenis yang ditunjukkan oleh dwSubjectType yang berisi tanda tangan yang akan diverifikasi.
[in] dwIssuerType
Jenis pengeluar sertifikat. Parameter ini bisa menjadi salah satu jenis pengeluar sertifikat berikut.
| Nilai | Makna |
|---|---|
|
pvIssuer adalah penunjuk ke struktur CERT_PUBLIC_KEY_INFO . |
|
pvIssuer adalah penunjuk ke struktur CCERT_CONTEXT . |
|
pvIssuer adalah penunjuk ke struktur CCERT_CHAIN_CONTEXT . |
|
pvIssuer harus NULL. |
[in] pvIssuer
Penunjuk ke struktur jenis yang ditunjukkan oleh nilai dwIssuerType. Struktur berisi akses ke kunci publik yang diperlukan untuk memverifikasi tanda tangan.
[in] dwFlags
Bendera yang mengubah perilaku fungsi. Ini bisa nol atau bitwise ATAU dari nilai berikut.
| Nilai | Makna |
|---|---|
|
Jika Anda mengatur bendera ini dan CryptVerifyCertificateSignatureEx mendeteksi algoritma MD2 atau MD4, fungsi mengembalikan FALSE dan mengatur GetLastError ke NTE_BAD_ALGID. Tanda tangan masih diverifikasi, tetapi kombinasi kesalahan ini memungkinkan pemanggil, sekarang mengetahui bahwa algoritma MD2 atau MD4 digunakan, untuk memutuskan apakah akan mempercayai atau menolak tanda tangan.
Windows 8 dan Windows Server 2012: Dukungan untuk bendera ini dimulai. |
|
Mengatur properti tanda tangan yang kuat, setelah verifikasi berhasil, pada subjek yang diacu oleh parameter pvSubject .
Properti berikut diatur pada konteks sertifikat:
Catatan Bendera ini hanya berlaku jika CRYPT_VERIFY_CERT_SIGN_SUBJECT_CRL ditentukan dalam parameter dwSubjectType .
|
|
Mengembalikan penunjuk ke struktur CRYPT_VERIFY_CERT_SIGN_STRONG_PROPERTIES_INFO dalam parameter pvExtra . Struktur berisi panjang, dalam bit, kunci umum dan nama algoritma penandatanganan dan hash yang digunakan.
Anda harus memanggil CryptMemFree untuk membebaskan struktur. Jika memori tidak dapat dialokasikan untuk struktur CRYPT_VERIFY_CERT_SIGN_STRONG_PROPERTIES_INFO , fungsi ini berhasil dikembalikan tetapi mengatur parameter pvExtra ke NULL. Catatan Bendera ini hanya berlaku jika CRYPT_VERIFY_CERT_SIGN_SUBJECT_OCSP_BASIC_SIGNED_RESPONSE ditentukan dalam parameter dwSubjectType .
|
[in, out, optional] pvExtra
Arahkan ke struktur CRYPT_VERIFY_CERT_SIGN_STRONG_PROPERTIES_INFO jika parameter dwFlags diatur ke CRYPT_VERIFY_CERT_SIGN_RETURN_STRONG_PROPERTIES_FLAG.
Anda harus memanggil CryptMemFree untuk membebaskan struktur.
Nilai kembali
Mengembalikan bukan nol jika berhasil atau nol sebaliknya.
Untuk informasi kesalahan yang diperluas, hubungi GetLastError.
| Menampilkan kode | Deskripsi |
|---|---|
|
Tipe pengodean sertifikat tidak valid. Saat ini hanya X509_ASN_ENCODING yang didukung. |
|
Pengidentifikasi objek algoritma tanda tangan (OID) tidak memetakan ke algoritma hash yang diketahui atau didukung. |
|
Tanda tangan tidak valid. |
Jika fungsi gagal, GetLastError dapat mengembalikan kesalahan pengodean/pendekodean Abstract Syntax Notation One (ASN.1). Untuk informasi tentang kesalahan ini, lihat Nilai Pengembalian Pengodean/Pendekodean ASN.1.
Keterangan
Buffer subjek dapat berisi BLOB yang dikodekan atau konteks untuk sertifikat atau CRL. Dalam kasus konteks sertifikat, jika parameter kunci publik sertifikat hilang dan jika parameter ini dapat diwarisi dari penerbit sertifikat misalnya dari parameter kunci publik DSS, properti CERT_PUBKEY_ALG_PARA_PROP_ID konteks diperbarui dengan parameter algoritma kunci publik penerbit untuk tanda tangan yang valid.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | wincrypt.h |
| Pustaka | Crypt32.lib |
| DLL | Crypt32.dll |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk