Enumerazione X500NameFlags (certenroll.h)

Il tipo di enumerazione X500NameFlags specifica le caratteristiche di visualizzazione e codifica di un nome distinto o di un nome distinto relativo (RDN). Questa enumerazione viene usata per inizializzare un oggetto IX500DistinguishedName .

Sintassi

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

Costanti

 
XCN_CERT_NAME_STR_NONE
Valore: 0
Le caratteristiche di visualizzazione non vengono identificate.
XCN_CERT_SIMPLE_NAME_STR
Valore: 1
Tutti gli identificatori di oggetto (OID) vengono eliminati. I nomi distinti relativi (RDN) sono separati da virgole seguite da uno spazio (, ). Gli attributi RDN sono separati da un segno più racchiuso tra spazi ( + ).
XCN_CERT_OID_NAME_STR
Valore: 2
Gli OID sono separati dal valore dell'attributo associato usando un segno di uguale (=). I nomi RDN sono separati da una virgola seguita da uno spazio (, ). Gli attributi RDN sono separati da un segno più seguito da uno spazio (+ ).
XCN_CERT_X500_NAME_STR
Valore: 3
Gli ID vengono convertiti nei nomi delle chiavi X.500 . Vengono separati dal valore dell'attributo associato usando un segno di uguale (=). I nomi RDN sono separati da una virgola seguita da uno spazio (, ). Gli attributi RDN sono separati da un segno più seguito da uno spazio (+ ).

Se un OID non ha un nome X.500 corrispondente, l'OID viene usato con un prefisso OID. La rete RDN è racchiusa tra virgolette (" ") se contiene spazi vuoti iniziali o finali o uno dei caratteri seguenti:

  • Virgola (,)

  • Segno più (+)

  • Segno di uguale (=)

  • Segno di pollice (")

  • Feed linea (\n)

  • Minore di segno (<)

  • Segno maggiore (>)

  • Segno numero (#)

  • Punto e virgola (;)

  • Virgolette incorporate (")

XCN_CERT_XML_NAME_STR
Valore: 4
Gli ID vengono trattati allo stesso modo di quelli usati per convertire i valori XCN_CERT_X500_NAME_ST, ad eccezione del fatto che vengono formattati come sequenza di elementi XML. come illustrato nell'esempio seguente.


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>

I caratteri di markup XML Unicode vengono escape nel modo seguente. I caratteri maggiori di 0x7F vengono escape usando i riferimenti ai caratteri (L"&#xXXXX;").

  • & diventa L"&"

  • < diventa L"<"

  • > diventa L">"

  • ' diventa L"'"

  • " diventa L"""

XCN_CERT_NAME_STR_SEMICOLON_FLAG
Valore: 0x40000000
Il separatore di virgole (,) usato tra RDN viene sostituito con un punto e virgola (;) carattere).
XCN_CERT_NAME_STR_NO_PLUS_FLAG
Valore: 0x20000000
Il separatore (+) usato tra attributi RDN viene sostituito con un singolo carattere di spazio.
XCN_CERT_NAME_STR_NO_QUOTING_FLAG
Valore: 0x10000000
Impedisce l'uso di virgolette per il valore XCN_CERT_X500_NAME_ST.
XCN_CERT_NAME_STR_CRLF_FLAG
Valore: 0x8000000
Il separatore di virgole (,) utilizzato tra RDN viene sostituito con una sequenza di ritorno/riga a capo (\r\n).
XCN_CERT_NAME_STR_COMMA_FLAG
Valore: 0x4000000
Specifica che il separatore tra RDN è una virgola (,).
XCN_CERT_NAME_STR_REVERSE_FLAG
Valore: 0x2000000
Specifica che l'ordine delle reti RDN che costituiscono il nome distinto (DN) viene invertito per la codifica. L'ordine di visualizzazione DN tipico è CN=name,...,DC=com. Usare questo flag per modificare l'ordine di codifica in DC=com,...,CN=name. Un oggetto IX500DistinguishedName imposta questo flag per impostazione predefinita, a meno che non si specifica XCN_CERT_NAME_STR_FORWARD_FLAG.
XCN_CERT_NAME_STR_FORWARD_FLAG
Valore: 0x1000000
Usare per annullare l'ordine di codifica specificato impostando il valore XCN_CERT_NAME_STR_REVERSE_FLAG.
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG
Valore: 0x10000
Ignora il tentativo iniziale di decodificare i valori dei caratteri T.61 Teletex nei valori UTF-8. Per impostazione predefinita, i valori T.61 vengono inizialmente decodificati in UTF-8, ma se la decodifica UTF-8 ha esito negativo, i valori vengono decodificati come caratteri a 8 bit.
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG
Valore: 0x20000
T.61 viene usato anziché la codifica dei caratteri Unicode per tutti i caratteri inferiori a 0xFF. LDAP, ad esempio, usa T.61.
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG
Valore: 0x40000
UTF-8 viene usato per la DN anziché la codifica di caratteri Unicode.
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG
Valore: 0x80000
Forza le chiavi X.500 seguenti da codificare come stringhe UTF-8 anziché stringhe Unicode stampabili.


































































ChiaveOID
CNXCN_OID_COMMON_NAME
GXCN_OID_GIVEN_NAME
GivenNameXCN_OID_GIVEN_NAME
GNXCN_OID_GIVEN_NAME
IXCN_OID_INITIALS
InizialiXCN_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
TitoloXCN_OID_TITLE
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG
Valore: 0x100000
Impedisce di forzare la codifica delle stringhe Unicode stampabili tramite UTF-8. Usare quando si desidera quando XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG è il comportamento predefinito.
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG
Valore: 0x200000
XCN_CERT_NAME_STR_DS_ESCAPED
Valore: 0x800000

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione certenroll.h

Vedi anche

Enumerazione CertEnroll

Interfacce CertEnroll

IX500DistinguishedName