Compartilhar via


Enumeração X500NameFlags (certenroll.h)

O tipo de enumeração X500NameFlags especifica as características de de exibição e codificação de um nome diferenciado ou rdn ( nome distinto relativo). Essa enumeração é usada para inicializar um objeto IX500DistinguishedName .

Sintaxe

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
As características de exibição não são identificadas.
XCN_CERT_SIMPLE_NAME_STR
Valor: 1
Todos os identificadores de objeto (OIDs) são descartados. Nomes distintos relativos (RDNs) são separados por vírgulas seguidas por um espaço (, ). Os atributos RDN são separados por um sinal de adição entre espaços ( + ).
XCN_CERT_OID_NAME_STR
Valor: 2
Os OIDs são separados de seu valor de atributo associado usando um sinal de igual (=). Os RDNs são separados por uma vírgula seguida por um espaço (, ). Os atributos RDN são separados por um sinal de adição seguido por um espaço (+ ).
XCN_CERT_X500_NAME_STR
Valor: 3
Os OIDs são convertidos em seus nomes de chave X.500. Eles são separados de seu valor de atributo associado usando um sinal de igual (=). Os RDNs são separados por uma vírgula seguida por um espaço (, ). Os atributos RDN são separados por um sinal de adição seguido por um espaço (+ ).

Se uma OID não tiver um nome X.500 correspondente, o OID será usado com um prefixo de OID. O RDN será colocado entre aspas (" ") se contiver espaço em branco à esquerda ou à direita ou um dos seguintes caracteres:

  • Vírgula (,)

  • Sinal de adição (+)

  • Sinal de igual (=)

  • Marca de polegada (")

  • Feed de linhas (\n)

  • Sinal menor que (<)

  • Maior que sinal (>)

  • Sinal de número (#)

  • Ponto e vírgula (;)

  • Aspas inseridas (")

XCN_CERT_XML_NAME_STR
Valor: 4
Os OIDs são tratados da mesma maneira que os usados para converter valores de XCN_CERT_X500_NAME_ST, exceto por serem formatados como uma sequência de elementos XML. Isso é mostrado no exemplo a seguir:


<CN>cart.contoso.com</CN>
<termos de uso da UO>em www.verisign.com/rpa (c)00</UO>
<UO rDNAttribute="true">operações de TI</UO>
<O>Contoso.com</O>
<L>Nova York</L>
<S>Nova York</S>
<C>us</C>
<oid="1.2.3.4" type="string">nome</RDN>
<RDN rDNAttribute="true" oid="1.2.1.3" type="encoded">0500</RDN>
<RDN oid="1.2.1.4" type="encoded">020135</RDN>
<RDN oid="1.2.2.5.3" type="octet">01FF7F</RDN>


Os caracteres de marcação XML Unicode são escapados da maneira a seguir. Caracteres maiores que 0x7F são escapados usando referências de caractere (L"&#xXXXX;").


  • & se torna "L"&"

  • < se torna L"<"

  • > se torna L">"

  • ' torna-se L"'"

  • " torna-se L"&aspas;"

XCN_CERT_NAME_STR_SEMICOLON_FLAG
Valor: 0x40000000
O separador de vírgula (,) usado entre RDNs é substituído por um ponto-e-vírgula (caractere ;).
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Valor: 0x20000000
O separador (+) usado entre atributos RDN é substituído por um único caractere de espaço.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Valor: 0x10000000
Inibe o uso de aspas para o valor XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Valor: 0x8000000
O separador de vírgula (,) usado entre RDNs é substituído por uma sequência de retorno de carro/alimentação de linha (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Valor: 0x4000000
Especifica que o separador entre RDNs é uma vírgula (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Valor: 0x2000000
Especifica que a ordem dos RDNs que compõem o DN (nome diferenciado) é revertida para codificação. A ordem de exibição de DN típica é CN=nome,...,DC=com. Use esse sinalizador para alterar a ordem de codificação para DC=com,...,CN=nome. Um objeto IX500DistinguishedName define esse sinalizador por padrão, a menos que você especifique XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Valor: 0x1000000
Use para desfazer a ordem de codificação especificada definindo o valor XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Valor: 0x10000
Ignora a tentativa inicial de decodificar valores de caractere de Teletex T.61 para valores UTF-8. Por padrão, os valores T.61 são inicialmente decodificados para UTF-8, mas se a decodificação UTF-8 falhar, os valores serão decodificados como caracteres de 8 bits.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Valor: 0x20000
T.61 é usado em vez de codificação de caractere Unicode para todos os caracteres menores que 0xFF. O LDAP, por exemplo, usa T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Valor: 0x40000
UTF-8 é usado para o DN (nome diferenciado) em vez de codificação de caractere Unicode.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Valor: 0x80000
Força as seguintes chaves X.500 a serem codificadas como cadeias de caracteres UTF-8 em vez de cadeias de caracteres Unicode imprimíveis. Veja a seguir a lista das chaves e seus identificadores de objeto correspondentes (OIDs).


  • CN - XCN_OID_COMMON_NAME

  • G - XCN_OID_GIVEN_NAME

  • GivenName - XCN_OID_GIVEN_NAME

  • GN – XCN_OID_GIVEN_NAME

  • Eu XCN_OID_INITIALS

  • Iniciais - XCN_OID_INITIALS

  • L - XCN_OID_LOCALITY_NAME

  • O - XCN_ORGANIZATION_NAME

  • UO - XCN_OID_ORGANIZATIONAL_UNIT_NAME

  • S - XCN_OID_STATE_OR_PROVINCE_NAME

  • SN - XCN_ID_SUR_NAME

  • ST – XCN_OID_STATE_OR_PROVINCE_NAME

  • RUA - XCN_OID_STREET_ADDRESS

  • T - XCN_OID_TITLE

  • Título – XCN_OID_TITLE

XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Valor: 0x100000
Impede forçar cadeias de caracteres Unicode imprimíveis a serem codificadas usando UTF-8. Use quando desejado quando XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG é o comportamento padrão.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Valor: 0x200000
Cadeias de caracteres que contêm caracteres Unicode são transcodificadas para Punycode, um subconjunto de caracteres ASCII limitado usado para nomes de host da Internet. Esse subconjunto de caracteres ASCII consiste em letras, dígitos e hifens.
XCN_CERT_NAME_STR_DS_ESCAPED
Valor: 0x800000
Escapa caracteres que não são permitidos em DNs (nomes distintos).

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
cabeçalho certenroll.h

Consulte também

Enumerações CertEnroll

interfaces CertEnroll

IX500DistinguishedName