CertGetCertificateContextProperty 函式 （wincrypt.h）

CertGetCertificateContextProperty 函式會擷取包含在 憑證內容擴充屬性中的資訊，。

語法

BOOL CertGetCertificateContextProperty(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwPropId,
  [out]     void           *pvData,
  [in, out] DWORD          *pcbData
);

參數

[in] pCertContext

包含要擷取之屬性之 憑證 之 CERT_CONTEXT 結構的指標。

[in] dwPropId

要擷取的屬性。 下表列出目前定義的標識碼和要 pvData 中傳回的數據類型。

CERT_ACCESS_STATE_PROP_ID

pvData的數據類型：DWORD 值的指標。

傳回 DWORD 值，指出是否保存憑證的寫入作業。 如果憑證位於記憶體存放區或以唯讀模式開啟的登錄存放區中，則不會設定 DWORD 值。

CERT_AIA_URL_RETRIEVED_PROP_ID

此標識碼是保留的。

CERT_ARCHIVED_KEY_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

針對憑證內容傳回先前儲存的加密密鑰 哈希。

CERT_ARCHIVED_PROP_ID

pvData的資料類型：NULL。 如果 CertGetCertificateContextProperty 函式傳回 true，則 CERT_CONTEXT存在指定的屬性標識符。

表示在列舉期間略過憑證。 找到具有此屬性集之憑證的明確搜尋作業，例如用來尋找具有特定哈希或序號之憑證的憑證。 pvData 中沒有任何數據與這個屬性相關聯。

CERT_AUTHORITY_INFO_ACCESS_PROP_ID

此標識碼是保留的。

CERT_AUTO_ENROLL_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回以 Null 終止的 Unicode 字串，此字串會為憑證自動註冊的憑證類型命名。

CERT_AUTO_ENROLL_RETRY_PROP_ID

此標識碼是保留的。

CERT_BACKED_UP_PROP_ID

此標識碼是保留的。

CERT_CA_DISABLE_CRL_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

針對 證書頒發機構單位（CA）所使用的憑證，停用 證書吊銷清單 （CRL） 擷取。 如果 CA 憑證包含這個屬性，它也必須包含 CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID 屬性。

CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

包含 在線憑證狀態通訊協定 （OCSP） URL 的清單，以用於 CA 憑證所簽發的憑證。 數位內容是 X509_AUTHORITY_INFO_ACCESS結構的 抽象語法表示法一 （ASN.1）編碼位元組，其中 pszAccessMethod 設定為 szOID_PKIX_OCSP。

CERT_CROSS_CERT_DIST_POINTS_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

跨憑證的位置。 目前，此標識碼僅適用於憑證，不適用於CRL或 憑證信任清單（CCL）。

BYTE 數位含 ASN.1 編碼的 CROSS_CERT_DIST_POINTS_INFO 結構，方法是使用 CryptDecodeObject 函式搭配 lpszStuctType 參數的 X509_CROSS_CERT_DIST_POINTS 值。

CERT_CTL_USAGE_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回位元組陣列，其中包含 ASN.1 編碼 CTL_USAGE 結構。

CERT_DATE_STAMP_PROP_ID

pvData的數據類型：FILETIME 結構的指標。

將憑證新增至存放區的時間。

CERT_DESCRIPTION_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回憑證 UI 所顯示的屬性。 此屬性可讓使用者描述憑證的使用。

CERT_EFS_PROP_ID

此標識碼是保留的。

CERT_ENHKEY_USAGE_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回包含 ASN.1 編碼 CERT_ENHKEY_USAGE 結構的位元組陣列。 此結構包含增強密鑰使用方式的數位，物件標識碼 （OIDs），每個標識元都會指定有效的憑證使用方式。

CERT_ENROLLMENT_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

包含 RequestID、CADNSName、CAName 和 DisplayName 之擱置要求的註冊資訊。 資料格式的定義如下：

位元組	內容
前 4 個字節	擱置的要求標識碼
接下來 4 個字節	CADNSName 大小，以字元為單位，包括終止 Null 字元，後面接著具有終止 Null 字元的 CADNSName 字串
接下來 4 個字節	CAName 大小，以字元為單位，包括終止 Null 字元，後面接著具有終止 Null 字元的 CAName 字串
接下來 4 個字節	DisplayName 大小，以字元為單位，包括終止 Null 字元，後面接著具有終止 Null 字元的 DisplayName 字串

CERT_EXTENDED_ERROR_INFO_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 Null 終止的 Unicode 字元字串，其中包含憑證內容的擴充錯誤資訊。

CERT_FORTEZZA_DATA_PROP_ID

此標識碼是保留的。

CERT_FRIENDLY_NAME_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 Null 終止的 Unicode 字元字串，其中包含憑證的顯示名稱。

CERT_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回SHA1哈希。 如果哈希不存在，則會使用 cryptHashCertificate 函式 來計算該哈希。

CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_ID

pvData的數據類型：HCRYPTPROV_OR_NCRYPT_KEY_HANDLE 數據類型的指標。

傳回 HCRYPTPROV 或 NCRYPT_KEY_HANDLE 選擇。

CERT_HCRYPTPROV_TRANSFER_PROP_ID

傳回與憑證相關聯的密碼編譯 API （CAPI） 密鑰句柄。 呼叫端負責釋放句柄。 當內容被釋放時，它將不會釋出。 屬性值會在傳回之後移除。 如果您在具有 CNG 索引鍵的內容上呼叫此屬性，則會傳回 CRYPT_E_NOT_FOUND。

CERT_IE30_RESERVED_PROP_ID

此標識碼是保留的。

CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

與用來簽署此憑證之 私鑰相關聯的 公鑰 MD5 哈希。

CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

此憑證中籤發者名稱和序號的 MD5 哈希。

CERT_KEY_CONTEXT_PROP_ID

pvData的數據類型：CERT_KEY_CONTEXT 結構的指標。

傳回 CERT_KEY_CONTEXT 結構。

CERT_KEY_IDENTIFIER_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

如果不存在，請搜尋 szOID_SUBJECT_KEY_IDENTIFIER 延伸模組。 如果失敗，則會在憑證的 SubjectPublicKeyInfo 成員上完成 SHA1 哈希，以產生標識符值。

CERT_KEY_PROV_HANDLE_PROP_ID

pvData的數據類型：HCRYPTPROV 值的指標。

傳回從 CERT_KEY_CONTEXT_PROP_ID 取得的提供者句柄。

CERT_KEY_PROV_INFO_PROP_ID

pvData的數據類型：CRYPT_KEY_PROV_INFO 結構的指標。

傳回 CRYPT_KEY_PROV_INFO 結構的指標。

CERT_KEY_SPEC_PROP_ID

pvData的數據類型：DWORD 值的指標。

傳回 DWORD 值，指定如果存在，則為從 CERT_KEY_CONTEXT_PROP_ID取得的私鑰。 否則，如果CERT_KEY_PROV_INFO_PROP_ID存在，則它是 dwKeySpec的來源。

CERT_MD5_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 MD5 哈希。 如果哈希不存在，則會使用 cryptHashCertificate 函式 來計算該哈希。

CERT_NCRYPT_KEY_HANDLE_PROP_ID

pvData的數據類型：NCRYPT_KEY_HANDLE 數據類型的指標。

傳回適用的 CERT_NCRYPT_KEY_SPEC 選擇。

CERT_NCRYPT_KEY_HANDLE_TRANSFER_PROP_ID

傳回與憑證相關聯的 CNG 金鑰句柄。 呼叫端負責釋放句柄。 當內容被釋放時，它將不會釋出。 屬性值會在傳回之後移除。 如果您在具有舊版 （CAPI） 索引鍵的內容上呼叫此屬性，則會傳回 CRYPT_E_NOT_FOUND。

CERT_NEW_KEY_PROP_ID

此標識碼是保留的。

CERT_NEXT_UPDATE_LOCATION_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 ASN.1 編碼 CERT_ALT_NAME_INFO 結構。

CERT_NEXT_UPDATE_LOCATION_PROP_ID目前僅搭配 CTL 使用。

CERT_NO_AUTO_EXPIRE_CHECK_PROP_ID

此標識碼是保留的。

CERT_OCSP_CACHE_PREFIX_PROP_ID

此標識碼是保留的。

CERT_OCSP_RESPONSE_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回此憑證的編碼 OCSP 回應。

CERT_PUB_KEY_CNG_ALG_BIT_LENGTH_PROP_ID

pvData的數據類型：以 Null 終止的 Unicode 字串指標。

傳回代表憑證公鑰演演算法和位長度的 L"<PUBKEY><BITLENGTH>" 字串。 支援下列 <PUBKEY> 演算法：

• L“RSA” （BCRYPT_RSA_ALGORITHM）
• L“DSA” （BCRYPT_DSA_ALGORITHM）
• L“ECDSA” （SSL_ECDSA_ALGORITHM）

Windows 8 和 Windows Server 2012： 支援此屬性開始。

CERT_PUBKEY_ALG_PARA_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

針對支援演算法參數繼承的公鑰，傳回 ASN.1 編碼的 PublicKey 演算法參數。 針對 數位簽名標準 （DSS），會傳回使用 CryptEncodeObject 函式編碼的參數。 只有在定義CMS_PKCS7時，才會使用這個屬性。

CERT_PUBKEY_HASH_RESERVED_PROP_ID

此標識碼是保留的。

CERT_PVK_FILE_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 Null 終止的 Unicode 寬字元字串，其中包含包含與憑證公鑰相關聯之私鑰的檔名。

CERT_RENEWAL_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回更新憑證的哈希。

CERT_REQUEST_ORIGINATOR_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回 Null 終止的 Unicode 字串，其中包含憑證內容要求來源的 DNS 計算機名稱。

CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回編碼 CERT_POLICIES_INFO 結構的指標，其中包含內容之跟證書的應用程式原則。 此屬性可以使用 CryptDecodeObject 函式譯碼，並將 lpszStructType 參數設定為 X509_CERT_POLICIES，並將 dwCertEncodingType 參數設定為 X509_ASN_ENCODING 位 ORPKCS_7_ASN_ENCODING的組合。

CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_ID

此標識碼是保留的。

CERT_SHA1_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回SHA1哈希。 如果哈希不存在，則會使用 cryptHashCertificate 函式 來計算該哈希。

CERT_SHA1_SHA256_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是52個字節、SHA1 哈希的20個字節，而SHA256哈希為32個字節。

傳回SHA1哈希和SHA256哈希的組合。 如果哈希不存在，則會使用 cryptHashCertificate 函式 來計算該哈希。

CERT_SHA256_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回SHA256哈希。 如果哈希不存在，則會使用 cryptHashCertificate 函式 來計算該哈希。

CERT_SIGN_HASH_CNG_ALG_PROP_ID

pvData的數據類型：以 Null 終止的 Unicode 字串指標。

傳回代表憑證簽章的 L"<SIGNATURE>/<HASH>" 字串。 <SIGNATURE> 值會識別 CNG 公鑰演演算法。 支援下列演算法：

• L“RSA” （BCRYPT_RSA_ALGORITHM）
• L“DSA” （BCRYPT_DSA_ALGORITHM）
• L“ECDSA” （SSL_ECDSA_ALGORITHM）

<HASH> 值會識別 CNG 哈希演算法。 支援下列演算法：

• L“MD5” （BCRYPT_MD5_ALGORITHM）
• L“SHA1” （BCRYPT_SHA1_ALGORITHM）
• L“SHA256” （BCRYPT_SHA256_ALGORITHM）
• L“SHA384” （BCRYPT_SHA384_ALGORITHM）
• L“SHA512” （BCRYPT_SHA512_ALGORITHM）

以下是常見的範例：

• L“RSA/SHA1”
• L“RSA/SHA256”
• L“ECDSA/SHA256”

Windows 7 和 Windows Server 2008 R2： 此屬性的支持開始。

CERT_SIGNATURE_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回簽章哈希。 如果哈希不存在，則會使用 CryptHashToBeSigned 函式來計算該哈希。 哈希的長度是SHA的20個字節，MD5為16個字節。

CERT_SMART_CARD_DATA_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回已編碼智慧卡數據的指標。 在呼叫 CertGetCertificateContextProperty之前，您可以使用這個常數來擷取智慧卡憑證，方法是使用 CertFindCertificateInStore函式，並將 pvFindPara 參數設定為 CERT_SMART_CARD_DATA_PROP_ID，並將 dwFindType 參數設定為 CERT_FIND_PROPERTY。

CERT_SMART_CARD_ROOT_INFO_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回編碼 CRYPT_SMART_CARD_ROOT_INFO 結構的指標。

CERT_SOURCE_LOCATION_PROP_ID

此標識碼是保留的。

CERT_SOURCE_URL_PROP_ID

此標識碼是保留的。

CERT_SUBJECT_DISABLE_CRL_PROP_ID

此標識碼是保留的。

CERT_SUBJECT_INFO_ACCESS_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回憑證內容的主體資訊存取延伸，做為編碼 CERT_SUBJECT_INFO_ACCESS 結構。

CERT_SUBJECT_NAME_MD5_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回憑證內容之編碼主體名稱的 MD5 哈希。

CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID

此標識碼是保留的。

CERT_SUBJECT_PUB_KEY_BIT_LENGTH_PROP_ID

pvData的數據類型：DWORD 值的指標。

傳回憑證中公鑰的長度，以位為單位。

Windows 8 和 Windows Server 2012： 支援此屬性開始。

CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_ID

pvData的數據類型：BYTE 值的陣列指標。 這個陣列的大小是在 參數中指定。

傳回此憑證公鑰的 MD5 哈希。

針對所有使用者定義屬性標識碼，pvData 指向 BYTE 值的陣列。

如需每個屬性標識碼的詳細資訊，請參閱 CertSetCertificateContextProperty中 dwPropId 參數的檔。

[out] pvData

要接收數據之緩衝區的指標，dwPropId所決定。 傳回之結構的成員所指向的結構也會在基底結構之後傳回。 因此， 中所包含的大小通常超過基底結構的大小。

這個參數可以 NULL，以設定記憶體配置資訊的大小。 如需詳細資訊，請參閱 擷取未知長度的數據。

[in, out] pcbData

DWORD 值的指標，指定 pvData 參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時，DWORD 值會包含要儲存在緩衝區中的位元元組數目。

若要在運行時間取得緩衝區的必要大小，請將 pvData 參數 NULL 傳遞，並將此參數指向的值設定為零。 如果 pvData 參數未 NULL，且 中指定的大小小於包含數據所需的位元元組數，則函式會失敗，GetLastError 傳回 ERROR_MORE_DATA，而且所需的大小會放在 參數所指向的變數中。

傳回值

如果函式成功，函式會傳回 true 。

如果函式失敗，它會 FALSE傳回 。 如需擴充錯誤資訊，請呼叫 getLastError。

一些可能的錯誤碼如下：

傳回碼	描述
CRYPT_E_NOT_FOUND	憑證沒有指定的 屬性。
ERROR_MORE_DATA	如果 pvData 參數指定的緩衝區不夠大，無法保存傳回的數據，則函式會設定 ERROR_MORE_DATA 程式代碼，並將所需的緩衝區大小以位元組為單位儲存在 所指向的變數中。

來自所呼叫函式的錯誤 CryptHashCertificate 可以傳播至此函式。

言論

屬性不會儲存在憑證內。 一般而言，在收到憑證回應之後，它們會與憑證相關聯，然後與存放區中的憑證一起儲存。 基於安全性考慮，建議您在儲存屬性值之前先驗證屬性值，並且只儲存資訊屬性，例如使用者存放區中的 CERT_FRIENDLY_NAME_PROP_ID 值。 所有其他屬性類型都應該儲存在本機計算機存放區中。

您的程式代碼可以使用宏來評估憑證內容的哈希類別。 如需詳細資訊，請參閱 CertSetCertificateContextProperty。

例子

如需使用此函式的範例，請參閱 範例 C 程式：取得和設定憑證屬性 和 範例 C 程式：列出存放區中的憑證。

要求

要求	價值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平臺	窗戶
標頭	wincrypt.h
連結庫	Crypt32.lib
DLL	Crypt32.dll

另請參閱

CERT_KEY_CONTEXT

CertCreateCertificateContext

CertSetCertificateContextProperty

CryptHashCertificate

CryptHashToBeSigned

擴充屬性函式