Функция CertRDNValueToStrA (wincrypt.h)

  • Статья

Функция CertRDNValueToStr преобразует имя в CERT_RDN_VALUE_BLOB в символьную строку, завершаемую null.

Синтаксис

DWORD CertRDNValueToStrA(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPSTR                psz,
  [in]  DWORD                csz
);

Параметры

[in] dwValueType

Указывает тип преобразуемого значения RDN.

Может иметь одно из следующих значений:

  • 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

Указатель на CERT_RDN_VALUE_BLOB типа, соответствующего dwValueType.

[out] psz

Указатель на буфер для получения возвращаемой строки.

[in] csz

Размер в символах, выделенный для возвращаемой строки. Размер должен включать завершающий символ NULL .

Возвращаемое значение

Возвращает количество преобразованных символов, включая завершающий символ NULL . Если psz имеет значение NULL или csz равно нулю, возвращает требуемый размер строки назначения.

Комментарии

Если psz не имеет значение NULL , а csz не равен нулю, возвращаемый psz всегда является пустой строкой, завершаемой null.

Примечание

Заголовок wincrypt.h определяет CertRDNValueToStr в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincrypt.h
Библиотека Crypt32.lib
DLL Crypt32.dll

См. также раздел

CertNameToStr

Функции преобразования данных