Fungsi CertGetIntendedKeyUsage (wincrypt.h)

Artikel
03/09/2024

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

Bagikan melalui