CERT_RDN_ATTR 結構 (wincrypt.h)
CERT_RDN_ATTR 結構包含相對辨別名稱的單一屬性， (RDN) 。 整個 RDN 會以包含CERT_RDN_ATTR結構的陣列CERT_RDN結構表示。
語法
typedef struct _CERT_RDN_ATTR {
LPSTR pszObjId;
DWORD dwValueType;
CERT_RDN_VALUE_BLOB Value;
} CERT_RDN_ATTR, *PCERT_RDN_ATTR;
成員
pszObjId
此結構中所定義屬性類型的物件標識碼 (OID) 。 此成員可以是下列其中一個 OID。
| 值 |
意義 |
- szOID_AUTHORITY_REVOCATION_LIST
|
安全性屬性。
|
- szOID_BUSINESS_CATEGORY
|
不區分大小寫的字串。
說明屬性。
|
- szOID_CA_CERTIFICATE
|
安全性屬性。
|
- szOID_CERTIFICATE_REVOCATION_LIST
|
安全性屬性。
|
- szOID_COMMON_NAME
|
不區分大小寫的字串。
標籤屬性。
|
- szOID_COUNTRY_NAME
|
可列印的雙字元字串。
地理屬性。
|
- szOID_CROSS_CERTIFICATE_PAIR
|
安全性屬性。
|
- szOID_DESCRIPTION
|
不區分大小寫的字串。 說明屬性。
|
- szOID_DESTINATION_INDICATOR
|
可列印的字串。
電信地址屬性。
|
- szOID_DEVICE_SERIAL_NUMBER
|
可列印的字串。
標籤屬性。
|
- szOID_DOMAIN_COMPONENT
|
IA5 字串。 DNS 名稱元件，例如 “com”。”
|
- szOID_FACSIMILE_TELEPHONE_NUMBER
|
電信地址屬性。
|
- szOID_GIVEN_NAME
|
不區分大小寫的字串。
Name 屬性。
|
- szOID_INITIALS
|
不區分大小寫的字串。 Name 屬性。
|
- szOID_INTERNATIONAL_ISDN_NUMBER
|
數值字串。
電信地址屬性。
|
- szOID_LOCALITY_NAME
|
不區分大小寫的字串。
地理屬性。
|
- szOID_MEMBER
|
關係型應用程式屬性。
|
- szOID_ORGANIZATION_NAME
|
不區分大小寫的字串。
組織屬性。
|
- szOID_ORGANIZATIONAL_UNIT_NAME
|
不區分大小寫的字串。
組織屬性。
|
- szOID_OWNER
|
關係型應用程式屬性。
|
- szOID_PHYSICAL_DELIVERY_OFFICE_NAME
|
不區分大小寫的字串。
郵件地址屬性。
|
- szOID_PKCS_12_FRIENDLY_NAME_ATTR
|
PKCS #12 屬性。
|
- szOID_PKCS_12_LOCAL_KEY_ID
|
PKCS #12 屬性。
|
- szOID_POST_OFFICE_BOX
|
不區分大小寫的字串。
郵件地址屬性。
|
- szOID_POSTAL_ADDRESS
|
可列印的字串。
郵件地址屬性。
|
- szOID_POSTAL_CODE
|
不區分大小寫的字串。
郵件地址屬性。
|
- szOID_PREFERRED_DELIVERY_METHOD
|
喜好設定屬性。
|
- szOID_PRESENTATION_ADDRESS
|
OSI 應用程式屬性。
|
- szOID_REGISTERED_ADDRESS
|
電信地址屬性。
|
- szOID_ROLE_OCCUPANT
|
關係型應用程式屬性。
|
- szOID_RSA_emailAddr
|
IA5 字串。
Email 屬性。
|
- szOID_SEARCH_GUIDE
|
說明屬性。
|
- szOID_SEE_ALSO
|
關係型應用程式屬性。
|
- szOID_STATE_OR_PROVINCE_NAME
|
不區分大小寫的字串。
地理屬性。
|
- szOID_STREET_ADDRESS
|
不區分大小寫的字串。
地理屬性。
|
- szOID_SUPPORTED_APPLICATION_CONTEXT
|
OSI 應用程式屬性。
|
- szOID_SUR_NAME
|
不區分大小寫的字串。
標籤屬性。
|
- szOID_TELEPHONE_NUMBER
|
電信地址屬性。
|
- szOID_TELETEXT_TERMINAL_IDENTIFIER
|
電信地址屬性。
|
- szOID_TELEX_NUMBER
|
電信地址屬性。
|
- szOID_TITLE
|
不區分大小寫的字串。
組織屬性。
|
- szOID_USER_CERTIFICATE
|
安全性屬性。
|
- szOID_USER_PASSWORD
|
安全性屬性。
|
- szOID_X21_ADDRESS
|
數值字串。
電信地址屬性。
|
dwValueType
表示 Value 成員的解譯。
這個成員可以是下列其中一個值。
| 值 |
意義 |
- CERT_RDN_ANY_TYPE
|
pszObjId 成員會決定假設的類型和長度。
|
- CERT_RDN_BMP_STRING
|
Unicode 字元陣列， (16 位) 。
|
- CERT_RDN_ENCODED_BLOB
|
編碼的數據 BLOB。
|
- CERT_RDN_GENERAL_STRING
|
目前未使用。
|
- CERT_RDN_GRAPHIC_STRING
|
目前未使用。
|
- CERT_RDN_IA5_STRING
|
IA5 的任意字串 (ASCII) 字元。
|
- CERT_RDN_INT4_STRING
|
INT4 元素的陣列， (32 位) 。
|
- CERT_RDN_ISO646_STRING
|
128 個字元集 (8 位) 。
|
- CERT_RDN_NUMERIC_STRING
|
只有字元 0 到 9，且空格字元 (8 位) 。
|
- CERT_RDN_OCTET_STRING
|
八位的任意字串 (8 位) 。
|
- CERT_RDN_PRINTABLE_STRING
|
可列印字元的任意字串， (8 位) 。
|
- CERT_RDN_T61_STRING
|
T.61 字元的任意字串 (8 位) 。
|
- CERT_RDN_TELETEX_STRING
|
T.61 字元的任意字串， (8 位) |
- CERT_RDN_UNICODE_STRING
|
Unicode 字元陣列， (16 位) 。
|
- CERT_RDN_UNIVERSAL_STRING
|
INT4 元素的陣列， (32 位) 。
|
- CERT_RDN_UTF8_STRING
|
16 位 Unicode 字元的陣列，以 16 位字元 UTF8 編碼在線路上，以一、二或三個、八位字元的序列編碼。
|
- CERT_RDN_VIDEOTEX_STRING
|
視訊文字字元的任意字串。
|
- CERT_RDN_VISIBLE_STRING
|
95 個字元集 (8 位) 。
|
下列旗標可以使用位 OR 運算結合 至 dwValueType 成員。
| 值 |
意義 |
- CERT_RDN_DISABLE_CHECK_TYPE_FLAG
|
用於編碼。 設定時，不會檢查字元，以判斷它們是否對實值型別有效。
|
- CERT_RDN_DISABLE_IE4_UTF8_FLAG
|
用於譯碼。 根據預設， CERT_RDN_T61_STRING 編碼的值一開始會譯碼為UTF8。 如果UTF8譯碼失敗，此值會譯碼為8位字元。 如果設定此旗標，它會略過初始嘗試譯碼為UTF8，並將值譯碼為8位字元。
|
- CERT_RDN_ENABLE_T61_UNICODE_FLAG
|
用於編碼。 設定時，如果所有 Unicode 字元都是 <= 0xFF，則會選取 CERT_RDN_T61_STRING 值，而不是 CERT_RDN_UNICODE_STRING 值。
|
- CERT_RDN_ENABLE_UTF8_UNICODE_FLAG
|
用於編碼。 設定時，字串會以 CERT_RDN_UTF8_STRING 值編碼，而不是 CERT_RDN_UNICODE_STRING 值。
|
- CERT_RDN_FORCE_UTF8_UNICODE_FLAG
|
用於編碼。 設定時，字串會以 CERT_RDN_UTF8_STRING 值編碼，而不是 CERT_RDN_PRINTABLE_STRING DirectoryString 類型的值。 此外， CERT_RDN_ENABLE_UTF8_UNICODE_FLAG 已啟用。
Windows Vista、Windows Server 2003 和 Windows XP： 不支援此旗標。
|
- CERT_RDN_ENABLE_PUNYCODE_FLAG
|
用於編碼。 如果字串包含電子郵件 RDN，且電子郵件位址為 Punycode 編碼，則產生的電子郵件地址會編碼為 IA5String。 主機名的 Punycode 編碼是以標籤為基礎執行。
用於譯碼。 如果名稱包含電子郵件 RDN，而電子郵件位址的本機部分或主機名部分包含 Punycode 編碼 的 IA5String，則 RDN 字串值會轉換成其 Unicode 對等專案。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援此旗標。
|
Value
包含屬性值 的CERT_RDN_VALUE_BLOB 。 Value 的 cbData 成員是 pbData 成員的長度，以位元組為單位。 它不是 pbData 字串中的元素數目。
例如， DWORD 為 32 位或 4 個字節長。 如果 pbData 是 DWORD 陣列， cbData 會是陣列中 DWORD 元素數目的四倍。 SHORT 為 16 位或 2 個字節長。 如果 pbData 是 SHORT 元素的陣列， cbData 必須是陣列長度的兩倍。
Value 的 pbData 成員可以是 8 位或 16 位字元的 Null 終止陣列，或元素的固定長度陣列。 如果 dwValueType 設定為 CERT_RDN_ENCODED_BLOB， 則 pbData 會編碼。
規格需求
| 需求 |
值 |
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 |
wincrypt.h |
另請參閱
CERT_RDN
CRYPT_INTEGER_BLOB
CertIsRDNAttrsInCertificateName