Enumeración X500NameFlags (certenroll.h)

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

Syntax

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). Los nombres distintivos relativos (RDN) están separados por comas seguidos 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 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. 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> 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 punto y coma (;) carácter.
XCN_CERT_NAME_STR_NO_PLUS_FLAG Valor: 0x20000000 El separador (+) usado entre atributos RDN se reemplaza por un solo carácter de espacio.
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 los RDN que componen el nombre distintivo (DN) se invierte para la codificación. El orden de visualización típico de DN es CN=name,...,DC=com. Use esta marca para cambiar el orden de codificación a DC=com,...,CN=name. Un objeto IX500DistinguishedName 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 los valores de caracteres de Teletex T.61 en valores UTF-8. De forma predeterminada, los valores 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 menores que 0xFF. LDAP, por ejemplo, usa T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG Valor: 0x40000 UTF-8 se usa para la 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. Clave 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 Initials XCN_OID_INITIALS L XCN_OID_LOCALITY_NAME O XCN_ORGANIZATION_NAME OU 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
XCN_CERT_NAME_STR_DS_ESCAPED Valor: 0x800000

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	certenroll.h

Consulte también

CertEnroll (enumeraciones)

CertEnroll Interfaces

IX500DistinguishedName