CertGetIntendedKeyUsage 函式 (wincrypt.h)
CertGetIntendedKeyUsage 函式會從憑證取得預期的密鑰使用位元組。 預期的密鑰使用方式可以是szOID_KEY_USAGE (“2.5.29.15”) 或 szOID_KEY_ATTRIBUTES (“2.5.29.2”) 延伸模組。
語法
BOOL CertGetIntendedKeyUsage(
[in] DWORD dwCertEncodingType,
[in] PCERT_INFO pCertInfo,
[out] BYTE *pbKeyUsage,
[in] DWORD cbKeyUsage
);
參數
[in] dwCertEncodingType
指定使用的編碼類型。 將憑證和 訊息編碼類型 與位 OR 作業結合在一起，一律可以接受，如下列範例所示：
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING目前定義的編碼類型如下：
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pCertInfo
指定之憑證 之CERT_INFO 結構的指標。
[out] pbKeyUsage
要接收預定金鑰使用方式之緩衝區的指標。 下列清單顯示目前定義的值。 您可以使用位 OR 作業來合併這些作業。
- CERT_DATA_ENCIPHERMENT_KEY_USAGE
- CERT_DIGITAL_SIGNATURE_KEY_USAGE
- CERT_KEY_AGREEMENT_KEY_USAGE
- CERT_KEY_CERT_SIGN_KEY_USAGE
- CERT_KEY_ENCIPHERMENT_KEY_USAGE
- CERT_NON_REPUDIATION_KEY_USAGE
- CERT_OFFLINE_CRL_SIGN_KEY_USAGE
[in] cbKeyUsage
pbKeyUsage 所指向之緩衝區的大小，以位元組為單位。 目前，預期的金鑰使用方式會佔用 1 或 2 個字節的數據。
傳回值
如果憑證沒有任何預期的密鑰使用位元節，則會傳回 FALSE ，並將 pbKeyUsage 設為零。 否則會傳回 TRUE，而且最多會複製到 pbKeyUsage 中的 cbKeyUsage 位元組數目。 未複製的任何剩餘位元組都是零的。
如果找不到任何必要的延伸模組，GetLastError 會傳回零。
如果函式失敗， GetLastError 可能會傳回 抽象語法表示法一 (ASN.1) 編碼/譯碼錯誤。 如需這些錯誤的相關信息，請參閱 ASN.1 編碼/譯碼傳回值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | wincrypt.h |
| 程式庫 | Crypt32.lib |
| Dll | Crypt32.dll |