EncodingType enumeration (certenroll.h)
The EncodingType enumeration specifies the type of encoding applied to a byte array for display purposes.
Syntax
typedef enum EncodingType {
XCN_CRYPT_STRING_BASE64HEADER,
XCN_CRYPT_STRING_BASE64,
XCN_CRYPT_STRING_BINARY,
XCN_CRYPT_STRING_BASE64REQUESTHEADER,
XCN_CRYPT_STRING_HEX,
XCN_CRYPT_STRING_HEXASCII,
XCN_CRYPT_STRING_BASE64_ANY,
XCN_CRYPT_STRING_ANY,
XCN_CRYPT_STRING_HEX_ANY,
XCN_CRYPT_STRING_BASE64X509CRLHEADER,
XCN_CRYPT_STRING_HEXADDR,
XCN_CRYPT_STRING_HEXASCIIADDR,
XCN_CRYPT_STRING_HEXRAW,
XCN_CRYPT_STRING_BASE64URI,
XCN_CRYPT_STRING_ENCODEMASK,
XCN_CRYPT_STRING_CHAIN,
XCN_CRYPT_STRING_TEXT,
XCN_CRYPT_STRING_PERCENTESCAPE,
XCN_CRYPT_STRING_HASHDATA,
XCN_CRYPT_STRING_STRICT,
XCN_CRYPT_STRING_NOCRLF,
XCN_CRYPT_STRING_NOCR
} ;
Constants
Name | Description |
---|---|
XCN_CRYPT_STRING_BASE64HEADER | The string is base64 encoded with beginning and ending certificate headers. Base64 is an encoding scheme used to transmit binary data. The data to be encoded is examined three bytes at a time. Every six bits in the 24-bit buffer is used as an index into a text string. The strings used vary depending on the type of data being encoded. The following string is commonly used for Multipurpose Internet Mail Extensions (MIME) email base64 encoding.
The following example shows a certificate that is base64 encoded and includes the beginning and ending headers.
|
XCN_CRYPT_STRING_BASE64 | The string is base64 encoded without beginning and ending certificate headers. |
XCN_CRYPT_STRING_BINARY | The string is a pure binary sequence. It is not encoded. |
XCN_CRYPT_STRING_BASE64REQUESTHEADER | The string is base64 encoded with beginning and ending certificate request headers. This is shown in the following example.
|
XCN_CRYPT_STRING_HEX | The string is hexadecimal encoded. Each 4-bit nibble of the string is represented as a number between zero and nine or a letter between A and F (or a and f). This is shown in the following example.
|
XCN_CRYPT_STRING_HEXASCII | The string is hexadecimal encoded, and the corresponding ASCII characters are displayed. This is shown in the following example.
|
XCN_CRYPT_STRING_BASE64_ANY | The string is base64 encoded. Enumeration values are tried in the following order:
|
XCN_CRYPT_STRING_ANY | Enumeration values are tried in the following order:
The XCN_CRYPT_STRING_BINARY value always succeeds. |
XCN_CRYPT_STRING_HEX_ANY | Enumeration values are tried in the following order:
|
XCN_CRYPT_STRING_BASE64X509CRLHEADER | The string is base64 encoded with beginning and ending X.509 certificate revocation list (CRL) headers. This is shown in the following example.
|
XCN_CRYPT_STRING_HEXADDR | The string is hexadecimal encoded and displayed as a hexadecimal address. This is shown in the following example.
|
XCN_CRYPT_STRING_HEXASCIIADDR | The string is hexadecimal encoded and displayed as a hexadecimal address along with the corresponding ASCII characters. This is shown in the following example.
|
XCN_CRYPT_STRING_HEXRAW | The string is hexadecimal encoded and displayed without punctuation. XCN_CRYPT_STRING_HEXRAW is available only with Windows Vista.
|
XCN_CRYPT_STRING_BASE64URI | |
XCN_CRYPT_STRING_ENCODEMASK | |
XCN_CRYPT_STRING_CHAIN | |
XCN_CRYPT_STRING_TEXT | |
XCN_CRYPT_STRING_PERCENTESCAPE | |
XCN_CRYPT_STRING_HASHDATA | |
XCN_CRYPT_STRING_STRICT | |
XCN_CRYPT_STRING_NOCRLF | Removes carriage return and line feed control characters from the encoded string. |
XCN_CRYPT_STRING_NOCR | Removes the carriage return control character from the encoded string. |
Requirements
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Header | certenroll.h |