Share via

Fungsi CertRDNValueToStrA (wincrypt.h)

  • Artikel

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

Lihat juga

CertNameToStr

Fungsi Konversi Data