Enumerazione X500NameFlags (certenroll.h)
Il tipo di enumerazione x X500NameFlags specifica le caratteristiche di visualizzazione e codifica di un nome distinto o nome distinto relativo (RDN). Questa enumerazione viene utilizzata 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_NONEValore: 0 Le caratteristiche di visualizzazione non vengono identificate. |
XCN_CERT_SIMPLE_NAME_STRValore: 1 Tutti gli identificatori di oggetto (OID) vengono eliminati. 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_STRValore: 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_STRValore: 3 Gli OID vengono convertiti nei nomi di chiave X.500. 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 (+ ). 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:
|
XCN_CERT_XML_NAME_STRValore: 4 Gli OID vengono trattati nello stesso modo usato per convertire XCN_CERT_X500_NAME_ST valori, ad eccezione del fatto che vengono formattati come sequenza di elementi XML. Questo è illustrato nell'esempio seguente: I caratteri di markup XML Unicode vengono preceduti da un carattere di escape nel modo seguente. I caratteri maggiori di 0x7F vengono preceduti da caratteri di escape tramite riferimenti di carattere (L"&#xXXXX;").
|
XCN_CERT_NAME_STR_SEMICOLON_FLAGValore: 0x40000000 Il separatore di virgole (,) utilizzato tra rdn viene sostituito da un punto e virgola (;) carattere. |
XCN_CERT_NAME_STR_NO_PLUS_FLAGValore: 0x20000000 Il separatore (+) usato tra gli attributi RDN viene sostituito con un singolo carattere di spazio. |
XCN_CERT_NAME_STR_NO_QUOTING_FLAGValore: 0x10000000 Impedisce l'uso delle virgolette per il valore XCN_CERT_X500_NAME_ST. |
XCN_CERT_NAME_STR_CRLF_FLAGValore: 0x8000000 Il separatore virgola (,) usato tra rdn viene sostituito con una sequenza ritorno a capo/avanzamento riga (\r\n). |
XCN_CERT_NAME_STR_COMMA_FLAGValore: 0x4000000 Specifica che il separatore tra rdn è una virgola (,). |
XCN_CERT_NAME_STR_REVERSE_FLAGValore: 0x2000000 Specifica che l'ordine dei nomi RDN che costituiscono il nome distinto (DN) viene invertito per la codifica. L'ordine di visualizzazione DN tipico è CN=nome,...,DC=com. Usare questo flag per modificare l'ordine di codifica in DC=com,...,CN=nome. Un oggetto IX500DistinguishedName imposta questo flag per impostazione predefinita, a meno che non si specifichi XCN_CERT_NAME_STR_FORWARD_FLAG. |
XCN_CERT_NAME_STR_FORWARD_FLAGValore: 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_FLAGValore: 0x10000 Ignora il tentativo iniziale di decodificare i valori dei caratteri di teletex T.61 in 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_FLAGValore: 0x20000 T.61 viene usato anziché la codifica dei caratteri Unicode per tutti i caratteri minori di 0xFF. LDAP, ad esempio, usa T.61. |
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAGValore: 0x40000 UTF-8 viene usato per il nome distinto (DN) anziché per la codifica dei caratteri Unicode. |
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAGValore: 0x80000 Forza la codifica delle chiavi X.500 seguenti come stringhe UTF-8 anziché stringhe Unicode stampabili. Di seguito è riportato l'elenco delle chiavi e dei relativi identificatori di oggetto (OID).
|
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAGValore: 0x100000 Impedisce 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_FLAGValore: 0x200000 Le stringhe contenenti caratteri Unicode vengono transcodificate in Punycode, un subset di caratteri ASCII limitato usato per i nomi host Internet. Questo sottoinsieme di caratteri ASCII è costituito da lettere, cifre e trattini. |
XCN_CERT_NAME_STR_DS_ESCAPEDValore: 0x800000 Caratteri di escape non consentiti nei nomi distinti (DN). |
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2008 [solo app desktop] |
| intestazione |
certenroll.h |