Fungsi CertIsRDNAttrsInCertificateName (wincrypt.h)

Artikel
08/27/2023

Fungsi CertIsRDNAttrsInCertificateName membandingkan atribut dalam nama sertifikat dengan CERT_RDN yang ditentukan untuk menentukan apakah semua atribut disertakan di sana. Perbandingan berulang melalui CERT_RDN dan mencari kecocokan atribut di salah satu CERT_RDNnama sertifikat.

Sintaks

BOOL CertIsRDNAttrsInCertificateName(
  [in] DWORD           dwCertEncodingType,
  [in] DWORD           dwFlags,
  [in] PCERT_NAME_BLOB pCertName,
  [in] PCERT_RDN       pRDN
);

Parameter

[in] dwCertEncodingType

Menentukan jenis pengodean yang digunakan. Selalu dapat diterima untuk menentukan jenis pengodean sertifikat dan pesan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Jenis pengodean yang saat ini ditentukan adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] dwFlags

CERT_UNICODE_IS_RDN_ATTRS_FLAG harus diatur jika pRDN diinisialisasi dengan string Unicode seperti dalam CryptEncodeObject dengan lpszStructType diatur ke X509_UNICODE_NAME.

CERT_CASE_INSENSITIVE_IS_RDN_ATTRS_FLAG diatur untuk melakukan kecocokan kasus yang tidak sensitif. Jika tidak, kecocokan sensitif huruf besar/kecil yang tepat akan dilakukan.

[in] pCertName

Penunjuk ke CRYPT_INTEGER_BLOB yang berisi subjek atau nama penerbit yang dikodekan.

[in] pRDN

Array struktur CERT_RDN yang berisi atribut yang akan ditemukan dalam nama. Anggota CERT_RDN_ATTR struktur CERT_RDN ber perilaku sesuai dengan aturan berikut.

Jika pszObjId adalah NULL, pengidentifikasi objek atribut (OID) diabaikan.
Jika dwValueType CERT_RDN_ANY_TYPE, jenis nilai diabaikan.
Jika anggota pbDataDari Nilai adalah NULL, nilai apa pun bisa cocok.

Nilai kembali

Jika fungsi berhasil dan semua nilai RDN dalam CERT_RDN yang ditentukan berada dalam nama sertifikat, nilai yang dikembalikan bukan nol (TRUE).

Jika fungsi gagal, atau jika ada nilai RDN dalam CERT_RDN yang ditentukan yang tidak ada dalam nama sertifikat, nilai yang dikembalikan adalah nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Tabel berikut ini mencantumkan beberapa kemungkinan kode kesalahan.

Menampilkan kode	Deskripsi
CRYPT_E_NO_MATCH	Tidak semua atribut ditemukan dan cocok.
ERROR_FILE_NOT_FOUND	Tipe pengodean sertifikat tidak valid. Saat ini hanya X509_ASN_ENCODING yang didukung.

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

Saat ini, hanya kecocokan yang tepat dan peka huruf besar/kecil yang didukung.

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

CertFindCertificateInStore

Fungsi Manajemen Data

Bagikan melalui