X500NameFlags 열거형(certenroll.h)
X500NameFlags 열거형 형식은 고유 이름 또는 RDN(상대 고유 이름)의 표시 및 인코딩 특성을 지정합니다. 이 열거형은 IX500DistinguishedName 개체를 초기화하는 데 사용됩니다.
통사론
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
} ;
상수
XCN_CERT_NAME_STR_NONE값: 0 표시 특성이 식별되지 않습니다. |
XCN_CERT_SIMPLE_NAME_STR값: 1 모든 개체 식별자(OID)는 삭제됩니다. RDN(Relative distinguished name)은 공백(, )과 쉼표로 구분됩니다. RDN 특성은 공백(+)에 묶인 더하기 기호로 구분됩니다. |
XCN_CERT_OID_NAME_STR값: 2 OID는 등호(=)를 사용하여 연결된 특성 값과 구분됩니다. RDN은 공백(, )과 쉼표로 구분됩니다. RDN 특성은 더하기 기호와 공백(+)으로 구분됩니다. |
XCN_CERT_X500_NAME_STR값: 3 OID는 X.500 키 이름으로 변환됩니다. 등호(=)를 사용하여 연결된 특성 값과 구분됩니다. RDN은 공백(, )과 쉼표로 구분됩니다. RDN 특성은 더하기 기호와 공백(+)으로 구분됩니다. OID에 해당 X.500 이름이 없는 경우 OID는 OID 접두사로 사용됩니다. RDN은 선행 또는 후행 공백 또는 다음 문자 중 하나가 포함된 경우 따옴표(" ")로 묶입니다.
|
XCN_CERT_XML_NAME_STR값: 4 OID는 XML 요소 시퀀스로 형식이 지정된다는 점을 제외하고 XCN_CERT_X500_NAME_ST 값을 변환하는 데 사용되는 것과 동일한 방식으로 처리됩니다. 다음 예제에 나와 있습니다. 유니코드 XML 태그 문자는 다음과 같이 이스케이프됩니다. 0x7F보다 큰 문자는 문자 참조(L"&#xXXXX;")를 사용하여 이스케이프됩니다.
|
XCN_CERT_NAME_STR_SEMICOLON_FLAG값: 0x40000000 RDN 간에 사용되는 쉼표(,) 구분 기호는 세미콜론(;) 문자)으로 바뀝니다. |
XCN_CERT_NAME_STR_NO_PLUS_FLAG값: 0x20000000 RDN 특성 간에 사용되는 (+) 구분 기호는 단일 공백 문자로 바뀝니다. |
XCN_CERT_NAME_STR_NO_QUOTING_FLAG값: 0x10000000 XCN_CERT_X500_NAME_ST 값에 따옴표를 사용하지 않습니다. |
XCN_CERT_NAME_STR_CRLF_FLAG값: 0x8000000 RDN 간에 사용되는 쉼표(,) 구분 기호는 캐리지 리턴/줄 바꿈(\r\n) 시퀀스로 바뀝니다. |
XCN_CERT_NAME_STR_COMMA_FLAG값: 0x4000000 RDN 사이의 구분 기호가 쉼표(,)임을 지정합니다. |
XCN_CERT_NAME_STR_REVERSE_FLAG값: 0x2000000 DN(고유 이름)을 구성하는 RDN의 순서가 인코딩에 역방향되도록 지정합니다. 일반적인 DN 표시 순서는 CN=이름,...,DC=com. 이 플래그를 사용하여 인코딩 순서를 DC=com,...,CN=이름변경합니다. IX500DistinguishedName 개체는 XCN_CERT_NAME_STR_FORWARD_FLAG 지정하지 않는 한 기본적으로 이 플래그를 설정합니다. |
XCN_CERT_NAME_STR_FORWARD_FLAG값: 0x1000000 XCN_CERT_NAME_STR_REVERSE_FLAG 값을 설정하여 지정한 인코딩 순서를 실행 취소하는 데 사용합니다. |
XCN_CERT_NAME_STR_AMBIGUOUS_SEPARATOR_FLAGS |
XCN_CERT_NAME_STR_DISABLE_IE4_UTF8_FLAG값: 0x10000 T.61 Teletex 문자 값을 UTF-8 값으로 디코딩하려는 초기 시도를 건너뜁니다. 기본적으로 T.61 값은 처음에 UTF-8로 디코딩되지만 UTF-8 디코딩이 실패하면 값이 8비트 문자로 디코딩됩니다. |
XCN_CERT_NAME_STR_ENABLE_T61_UNICODE_FLAG값: 0x20000 T.61은 0xFF 미만의 모든 문자에 대해 유니코드 문자 인코딩이 아닌 사용됩니다. 예를 들어 LDAP는 T.61을 사용합니다. |
XCN_CERT_NAME_STR_ENABLE_UTF8_UNICODE_FLAG값: 0x40000 UTF-8은 유니코드 문자 인코딩 대신 DN(고유 이름)에 사용됩니다. |
XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG값: 0x80000 다음 X.500 키를 인쇄 가능한 유니코드 문자열이 아닌 UTF-8 문자열로 인코딩하도록 합니다. 다음은 키 및 해당 개체 식별자(OID)의 목록입니다.
|
XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG값: 0x100000 UTF-8을 사용하여 인쇄 가능한 유니코드 문자열을 강제로 인코딩하지 않도록 합니다. XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG 기본 동작인 경우 원하는 경우에 사용합니다. |
XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG값: 0x200000 유니코드 문자가 포함된 문자열은 인터넷 호스트 이름에 사용되는 제한된 ASCII 문자 하위 집합인 Punycode로 변환됩니다. ASCII 문자의 이 하위 집합은 문자, 숫자 및 하이픈으로 구성됩니다. |
XCN_CERT_NAME_STR_DS_ESCAPED값: 0x800000 DN(고유 이름)에서 허용되지 않는 문자를 이스케이프합니다. |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 | certenroll.h |