Fungsi CertGetIntendedKeyUsage (wincrypt.h)

  • Artikel

Fungsi CertGetIntendedKeyUsage memperoleh byte penggunaan kunci yang dimaksudkan dari sertifikat. Penggunaan kunci yang dimaksudkan dapat berada di ekstensi szOID_KEY_USAGE ("2.5.29.15") atau szOID_KEY_ATTRIBUTES ("2.5.29.2").

Sintaks

BOOL CertGetIntendedKeyUsage(
  [in]  DWORD      dwCertEncodingType,
  [in]  PCERT_INFO pCertInfo,
  [out] BYTE       *pbKeyUsage,
  [in]  DWORD      cbKeyUsage
);

Parameter

[in] dwCertEncodingType

Menentukan jenis pengodean yang digunakan. Selalu dapat diterima untuk menentukan jenis pengodean sertifikat dan pesan dengan menggabungkannya dengan operasi bitwise-OR seperti yang ditunjukkan dalam contoh berikut:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Jenis pengodean yang ditentukan saat ini adalah:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pCertInfo

Penunjuk ke struktur CERT_INFO sertifikat yang ditentukan.

[out] pbKeyUsage

Penunjuk ke buffer untuk menerima penggunaan kunci yang dimaksudkan. Daftar berikut ini memperlihatkan nilai yang saat ini ditentukan. Ini dapat dikombinasikan dengan menggunakan operasi bitwise-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

Ukuran, dalam byte, dari buffer yang diarahkan oleh pbKeyUsage. Saat ini, penggunaan kunci yang dimaksudkan menempati 1 atau 2 byte data.

Mengembalikan nilai

Jika sertifikat tidak memiliki byte penggunaan kunci yang dimaksudkan, FALSE dikembalikan dan pbKeyUsage dinilai nol. Jika tidak, TRUE dikembalikan dan hingga cbKeyUsage jumlah byte disalin ke pbKeyUsage. Byte yang tersisa yang tidak disalin adalah nol.

GetLastError mengembalikan nol jika tidak ada ekstensi yang diperlukan yang ditemukan.

Jika fungsi gagal, GetLastError dapat mengembalikan kesalahan pengodean/pendekodean Abstract Syntax Notation One (ASN.1). Untuk informasi tentang kesalahan ini, lihat Nilai Pengembalian Pengodean/Pendekodean ASN.1.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header wincrypt.h
Pustaka Crypt32.lib
DLL Crypt32.dll

Lihat juga

Fungsi Manajemen Data