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

Статья
11/20/2024

Функция CertRDNValueToStr преобразует имя в CERT_RDN_VALUE_BLOB в строку символов null-terminated.

Синтаксис

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 символа. Если psznull или csz равно нулю, возвращает требуемый размер конечной строки.

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	wincrypt.h
библиотеки	Crypt32.lib
DLL	Crypt32.dll

См. также

CertNameToStr

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

Поделиться через