Перечисление X500NameFlags (certenroll.h)

  • Статья

Тип перечисления X500NameFlags определяет характеристики отображения и кодирования различающегося имени или относительного различающегося имени (RDN). Это перечисление используется для инициализации объекта IX500DistinguishedName .

Синтаксис

typedef enum X500NameFlags {
  XCN_CERT_NAME_STR_NONE = 0,
  XCN_CERT_SIMPLE_NAME_STR = 1,
  XCN_CERT_OID_NAME_STR = 2,
  XCN_CERT_X500_NAME_STR = 3,
  XCN_CERT_XML_NAME_STR = 4,
  XCN_CERT_NAME_STR_SEMICOLON_FLAG = 0x40000000,
  XCN_CERT_NAME_STR_NO_PLUS_FLAG = 0x20000000,
  XCN_CERT_NAME_STR_NO_QUOTING_FLAG = 0x10000000,
  XCN_CERT_NAME_STR_CRLF_FLAG = 0x8000000,
  XCN_CERT_NAME_STR_COMMA_FLAG = 0x4000000,
  XCN_CERT_NAME_STR_REVERSE_FLAG = 0x2000000,
  XCN_CERT_NAME_STR_FORWARD_FLAG = 0x1000000,
  XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS,
  XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG = 0x10000,
  XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG = 0x20000,
  XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG = 0x40000,
  XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG = 0x80000,
  XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG = 0x100000,
  XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG = 0x200000,
  XCN_CERT_NAME_STR_DS_ESCAPED = 0x800000
} ;

Константы

 
XCN_CERT_NAME_STR_NONE
Значение: 0
Характеристики дисплея не идентифицируются.
XCN_CERT_SIMPLE_NAME_STR
Значение: 1
Все идентификаторы объектов (OID) удаляются. Относительные различающиеся имена (RDN) разделяются запятыми и пробелами (, ). Атрибуты RDN разделяются знаком "плюс", заключенным в пробелы ( + ).
XCN_CERT_OID_NAME_STR
Значение: 2
Идентификаторы OID отделяются от значения связанного атрибута с помощью знака равенства (=). RDN разделяются запятой, за которой следует пробел (, ). Атрибуты RDN разделяются знаком "плюс" и пробелом (+).
XCN_CERT_X500_NAME_STR
Значение: 3
Идентификаторы OID преобразуются в имена ключей X.500 . Они отделяются от значения связанного атрибута с помощью знака равенства (=). RDN разделяются запятой, за которой следует пробел (, ). Атрибуты RDN разделяются знаком "плюс" и пробелом (+).

Если OID не имеет соответствующего имени X.500, он используется с префиксом OID. RDN заключено в кавычки (" ") , если оно содержит начальные или конечные пробелы или один из следующих символов:

  • Запятая (,)

  • Знак "плюс" (+)

  • Знак равенства (=)

  • Дюйм (")

  • Канал строки (\n)

  • Знак "Меньше" (<)

  • Знак "Больше" (>)

  • Знак номера (#)

  • Точка с запятой (;)

  • Внедренные кавычки (")
XCN_CERT_XML_NAME_STR
Значение: 4
Идентификаторы OID обрабатываются так же, как и для преобразования XCN_CERT_X500_NAME_ST значений, за исключением того, что они форматируются как последовательность XML-элементов. Это показано в следующем примере.


syntax<br><br>&lt;CN&gt;cart.contoso.com&lt;/CN&gt;<br>&lt;OU&gt;Terms of use at www.verisign.com/rpa (c)00&lt;/OU&gt;<br>&lt;OU rDNAttribute="true"&gt;IT Operations&lt;/OU&gt;<br>&lt;O&gt;Contoso.com&lt;/O&gt;<br>&lt;L&gt;New York&lt;/L&gt;<br>&lt;S&gt;New York&lt;/S&gt;<br>&lt;C&gt;US&lt;/C&gt;<br>&lt;RDN oid="1.2.3.4" type="string"&gt;name&lt;/RDN&gt;<br>&lt;RDN rDNAttribute="true" oid="1.2.1.3" type="encoded"&gt;0500&lt;/RDN&gt;<br>&lt;RDN oid="1.2.1.4" type="encoded"&gt;020135&lt;/RDN&gt;<br>&lt;RDN oid="1.2.2.5.3" type="octet"&gt;01FF7F&lt;/RDN&gt;<br>

Символы разметки Юникод XML экранируются следующим образом. Символы, превышающие 0x7F, экранируются с помощью ссылок на символы (L"&#xXXXX;").

  • & становится L"&"

  • < становится L"<"

  • > становится L">"

  • ' становится L"'"

  • " становится L"""
XCN_CERT_NAME_STR_SEMICOLON_FLAG
Значение: 0x40000000
Разделитель запятых (,), используемый между RDN, заменяется точкой с запятой (;) символом.
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Значение: 0x20000000
Разделитель (+), используемый между атрибутами RDN, заменяется одним символом пробела.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Значение: 0x10000000
Препятствует использованию кавычек для значения XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Значение: 0x8000000
Разделитель запятых (,), используемый между RDN, заменяется последовательностью возврата каретки или перевода строки (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Значение: 0x4000000
Указывает, что разделителем между RDN является запятая (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Значение: 0x2000000
Указывает, что порядок RDN, составляющих различающееся имя (DN), будет обратным для кодирования. Типичный порядок отображения DN — CN=name,...,DC=com. Используйте этот флаг, чтобы изменить порядок кодирования на DC=com,...,CN=name. Объект IX500DistinguishedName устанавливает этот флаг по умолчанию, если не указано XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Значение: 0x1000000
Используйте для отмены порядка кодирования, заданного путем задания значения XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Значение: 0x10000
Пропускает начальную попытку декодировать значения символов T.61 Teletex в значения UTF-8. По умолчанию значения T.61 изначально декодируются в UTF-8, но если декодирование UTF-8 завершается сбоем, значения декодируются как 8-разрядные символы.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Значение: 0x20000
T.61 используется вместо кодировки Юникода для всех символов меньше 0xFF. Ldap, например, использует T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Значение: 0x40000
UTF-8 используется для DN вместо кодировки символов Юникода.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Значение: 0x80000
Принудительно кодирует следующие ключи X.500 как строки UTF-8, а не печатаемые строки Юникода.


































































КлючOID
CNXCN_OID_COMMON_NAME
GXCN_OID_GIVEN_NAME
GivenNameXCN_OID_GIVEN_NAME
GNXCN_OID_GIVEN_NAME
IXCN_OID_INITIALS
ИнициалыXCN_OID_INITIALS
LXCN_OID_LOCALITY_NAME
OXCN_ORGANIZATION_NAME
OUXCN_OID_ORGANIZATIONAL_UNIT_NAME
SXCN_OID_STATE_OR_PROVINCE_NAME
SNXCN_ID_SUR_NAME
STXCN_OID_STATE_OR_PROVINCE_NAME
STREETXCN_OID_STREET_ADDRESS
TXCN_OID_TITLE
ЗаголовокXCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Значение: 0x100000
Предотвращает принудительное кодирование печатаемых строк Юникода с помощью UTF-8. Используйте при необходимости, если XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG является поведением по умолчанию.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Значение: 0x200000
XCN_CERT_NAME_STR_DS_ESCAPED
Значение: 0x800000

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть certenroll.h

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

Перечисления CertEnroll

Интерфейсы CertEnroll

IX500DistinguishedName