Enumeração X500NameFlags (certenroll.h)

O tipo de enumeração X500NameFlags especifica as características de exibição e codificação de um nome distinto ou rdn ( nome diferenciado relativo ). Essa enumeração é usada para inicializar um 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 As características de exibição não são identificadas.
XCN_CERT_SIMPLE_NAME_STR Valor: 1 Todos os OIDs ( identificadores de objeto ) são descartados. Os RDNs (nomes distintos relativos) 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 um 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 (") Alimentação de linha (\n) Sinal menor que (<) Sinal maior que (>) 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 que são formatados como uma sequência de elementos XML. Isso é mostrado no exemplo a seguir. 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> 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 caracteres (L"&#xXXXX;"). & se torna L"&" < torna-se L"<" > torna-se L">" ' torna-se L"'" " torna-se L"""
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) é invertida para codificação. A ordem de exibição de DN típica é CN=name,...,DC=com. Use esse sinalizador para alterar a ordem de codificação para DC=com,...,CN=name. 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 O T.61 é usado em vez da codificação de caracteres 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 em vez da codificação de caracteres 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. Chave 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 Iniciais 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 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
XCN_CERT_NAME_STR_DS_ESCAPED Valor: 0x800000

Requisitos

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

Confira também

Enumerações CertEnroll

CertEnroll Interfaces

IX500DistinguishedName