Fungsi CertRDNValueToStrA (wincrypt.h)
Fungsi CertRDNValueToStr mengonversi nama dalam CERT_RDN_VALUE_BLOB menjadi string karakter yang dihentikan null.
Sintaks
DWORD CertRDNValueToStrA(
[in] DWORD dwValueType,
[in] PCERT_RDN_VALUE_BLOB pValue,
[out] LPSTR psz,
[in] DWORD csz
);
Parameter
[in] dwValueType
Menunjukkan jenis nilai RDN yang akan dikonversi.
Ini bisa menjadi salah satu nilai berikut:
- CERT_RDN_ANY_TYPE
- CERT_RDN_ENCODED_BLOB
- CERT_RDN_OCTET_STRING
- CERT_RDN_NUMERIC_STRING
- CERT_RDN_PRINTABLE_STRING
- CERT_RDN_TELETEX_STRING
- CERT_RDN_T61_STRING
- CERT_RDN_VIDEOTEX_STRING
- CERT_RDN_IA5_STRING
- CERT_RDN_GRAPHIC_STRING
- CERT_RDN_VISIBLE_STRING
- CERT_RDN_ISO646_STRING
- CERT_RDN_GENERAL_STRING
- CERT_RDN_UNIVERSAL_STRING
- CERT_RDN_INT4_STRING
- CERT_RDN_BMP_STRING
- CERT_RDN_UNICODE_STRING
- CERT_RDN_UTF8_STRING
[in] pValue
Penunjuk ke CERT_RDN_VALUE_BLOB jenis yang sesuai untuk dwValueType.
[out] psz
Penunjuk ke buffer untuk menerima string yang dikembalikan.
[in] csz
Ukuran, dalam karakter, dialokasikan untuk string yang dikembalikan. Ukuran harus menyertakan karakter NULL yang mengakhiri.
Nilai kembali
Mengembalikan jumlah karakter yang dikonversi, termasuk karakter NULL yang mengakhiri. Jika pszadalah NULL atau csz adalah nol, mengembalikan ukuran string tujuan yang diperlukan.
Keterangan
Jika psz bukan NULL dan csz bukan nol, psz yang dikembalikan selalu merupakan string kosong null-terminated yang mungkin kosong.
Catatan
Header wincrypt.h mendefinisikan CertRDNValueToStr sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | wincrypt.h |
Pustaka | Crypt32.lib |
DLL | Crypt32.dll |