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

另請參閱

資料管理 函式