Compartir a través de

Enumeración X500NameFlags (certenroll.h)

  • Artículo

El tipo de enumeración X500NameFlags especifica la presentación y codificación características de un nombre distintivo o nombre distintivo relativo (RDN). Esta enumeración se usa para inicializar un objeto IX500DistinguishedName.

Sintaxis

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
} ;

Constantes

 
XCN_CERT_NAME_STR_NONE
Valor: 0
No se identifican las características de visualización.
XCN_CERT_SIMPLE_NAME_STR
Valor: 1
Se descartan todos los identificadores de objeto (OID). Nombres distintivos relativos (RDN) están separados por comas seguidas de un espacio (, ). Los atributos RDN están separados por un signo más entre espacios ( + ).
XCN_CERT_OID_NAME_STR
Valor: 2
Los OID están separados de su valor de atributo asociado mediante un signo igual (=). Los RDN están separados por una coma seguida de un espacio (, ). Los atributos RDN están separados por un signo más seguido de un espacio (+ ).
XCN_CERT_X500_NAME_STR
Valor: 3
Los OID se convierten en sus nombres de clave de X.500. Se separan de su valor de atributo asociado mediante un signo igual (=). Los RDN están separados por una coma seguida de un espacio (, ). Los atributos RDN están separados por un signo más seguido de un espacio (+ ).

Si un OID no tiene un nombre X.500 correspondiente, el OID se usa con un prefijo de OID. El RDN se incluye entre comillas (" ") si contiene espacios en blanco iniciales o finales o uno de los siguientes caracteres:

  • Coma (,)

  • Signo más (+)

  • Signo igual (=)

  • Marca de pulgada (")

  • Avance de línea (\n)

  • Menor que el signo (<)

  • Mayor que el signo (>)

  • Signo de número (#)

  • Punto y coma (;)

  • Comillas incrustadas (")
XCN_CERT_XML_NAME_STR
Valor: 4
Los OID se tratan de la misma manera que los que se usan para convertir XCN_CERT_X500_NAME_ST valores, excepto que tienen formato como una secuencia de elementos XML. Esto se muestra en el ejemplo siguiente:



              <CN>cart.contoso.com</CN>

              <UO>Términos de uso en www.verisign.com/rpa (c)00</OU>

              <OU rDNAttribute="true">Operaciones de TI</OU>

              <O>Contoso.com</O>

              <L>New York</L>

              <S>New York</S>

              <C></C>

              <RDN oid="1.2.3.4" type="string">name</RDN>

              <RDN rDNAttribute="true" oid="1.2.1.3" type="codificado">0500</RDN>

              <RDN oid="1.2.1.4" type="codificado">020135</RDN>

              <RDN oid="1.2.2.5.3" type="octet">01FF7F</RDN>


Los caracteres de marcado XML Unicode se escapan de la siguiente manera. Los caracteres mayores que 0x7F se escapan mediante referencias de caracteres (L"&#xXXXX;").


  • & se convierte en L"&"

  • < se convierte en L"<"

  • > se convierte en L">"

  • ' se convierte en L"≈"

  • " se convierte en L"""
XCN_CERT_NAME_STR_SEMICOLON_FLAG
Valor: 0x40000000
El separador de comas (,) usado entre RDN se reemplaza por un carácter de punto y coma (;).
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Valor: 0x20000000
El separador (+) usado entre atributos RDN se reemplaza por un carácter de espacio único.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Valor: 0x10000000
Impide el uso de comillas para el valor de XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Valor: 0x8000000
El separador de comas (,) utilizado entre RDN se reemplaza por una secuencia de retorno de carro/avance de línea (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Valor: 0x4000000
Especifica que el separador entre RDN es una coma (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Valor: 0x2000000
Especifica que el orden de las RDN que componen el nombre distintivo (DN) se invierte para la codificación. El orden de visualización de DN típico es CN=nombre,...,DC=com. Use esta marca para cambiar el orden de codificación a DC=com,...,CN=nombre. Un IX500DistinguishedName objeto establece esta marca de forma predeterminada a menos que especifique XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Valor: 0x1000000
Use para deshacer el orden de codificación especificado estableciendo el valor de XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Valor: 0x10000
Omite el intento inicial de descodificar valores de caracteres T.61 Teletex a valores UTF-8. De forma predeterminada, los valores de T.61 se descodifican inicialmente en UTF-8, pero si se produce un error en la descodificación UTF-8, los valores se descodifican como caracteres de 8 bits.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Valor: 0x20000
T.61 se usa en lugar de codificación de caracteres Unicode para todos los caracteres inferiores a 0xFF. LDAP, por ejemplo, usa T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Valor: 0x40000
UTF-8 se usa para el nombre distintivo (DN) en lugar de la codificación de caracteres Unicode.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Valor: 0x80000
Obliga a codificar las siguientes claves X.500 como cadenas UTF-8 en lugar de cadenas Unicode imprimibles. A continuación se muestra la lista de las claves y sus identificadores de objeto correspondientes (OID).


  • CN: XCN_OID_COMMON_NAME

  • G : XCN_OID_GIVEN_NAME

  • GivenName: XCN_OID_GIVEN_NAME

  • GN: XCN_OID_GIVEN_NAME

  • I - XCN_OID_INITIALS

  • Iniciales: XCN_OID_INITIALS

  • L: XCN_OID_LOCALITY_NAME

  • O: XCN_ORGANIZATION_NAME

  • Unidad organizativa: XCN_OID_ORGANIZATIONAL_UNIT_NAME

  • S: XCN_OID_STATE_OR_PROVINCE_NAME

  • SN: XCN_ID_SUR_NAME

  • ST: XCN_OID_STATE_OR_PROVINCE_NAME

  • STREET - XCN_OID_STREET_ADDRESS

  • T: XCN_OID_TITLE

  • Título: XCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Valor: 0x100000
Impide forzar la codificación de cadenas Unicode imprimibles mediante UTF-8. Use cuando desee cuando XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG sea el comportamiento predeterminado.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Valor: 0x200000
Las cadenas que contienen caracteres Unicode se transcodifican a Punycode, un subconjunto de caracteres ASCII limitado que se usa para los nombres de host de Internet. Este subconjunto de caracteres ASCII consta de letras, dígitos y guiones.
XCN_CERT_NAME_STR_DS_ESCAPED
Valor: 0x800000
Caracteres de escape que no se permiten en nombres distintivos (DN).

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
encabezado de certenroll.h

Consulte también

CertEnroll (enumeraciones)

de interfaces certEnroll de

IX500DistinguishedName