Fungsi CryptCreateKeyIdentifierFromCSP (wincrypt.h)

Artikel
08/27/2023

Penting API ini tidak digunakan lagi. Perangkat lunak baru dan yang sudah ada harus mulai menggunakan Cryptography Next Generation API. Microsoft dapat menghapus API ini dalam rilis mendatang.

Fungsi CryptCreateKeyIdentifierFromCSP membuat pengidentifikasi kunci dari kunci publik penyedia layanan kriptografi (CSP) CRYPT_INTEGER_BLOB.

Fungsi ini mengonversi PUBLICKEYSTRUC dari CSP menjadi struktur CERT_PUBLIC_KEY_INFO X.509 dan mengodekannya. Struktur yang dikodekan kemudian di-hash dengan algoritma SHA1 untuk mendapatkan pengidentifikasi kunci.

Sintaks

BOOL CryptCreateKeyIdentifierFromCSP(
  [in]      DWORD                dwCertEncodingType,
  [in]      LPCSTR               pszPubKeyOID,
  [in]      const PUBLICKEYSTRUC *pPubKeyStruc,
  [in]      DWORD                cbPubKeyStruc,
  [in]      DWORD                dwFlags,
  [in]      void                 *pvReserved,
  [out]     BYTE                 *pbHash,
  [in, out] DWORD                *pcbHash
);

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 saat ini ditentukan adalah:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pszPubKeyOID

Penunjuk ke pengidentifikasi objek kunci publik (OID). Nilai yang bukan NULL mengambil alih OID default yang diperoleh dari anggota struktur aiKeyAlg yang ditujukkan oleh pPubKeyStruc. Untuk menggunakan OID default, atur pszPubKeyOID ke NULL.

[in] pPubKeyStruc

Penunjuk ke struktur PUBLICKEYSTRUC . Dalam kasus default, anggota aiKeyAlg dari struktur yang ditujukkan oleh pPubKeyStruc digunakan untuk menemukan OID kunci publik. Ketika nilai pszPubKeyOID bukan NULL, nilai tersebut akan mengambil alih default.

[in] cbPubKeyStruc

Ukuran, dalam byte, dari PUBLICKEYSTRUC.

[in] dwFlags

Dicadangkan untuk digunakan di masa mendatang dan harus nol.

[in] pvReserved

Dicadangkan untuk digunakan di masa mendatang dan harus NULL.

[out] pbHash

Penunjuk ke buffer untuk menerima hash kunci umum dan pengidentifikasi kunci.

Untuk mendapatkan ukuran informasi ini untuk tujuan alokasi memori, atur parameter ini ke NULL. Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbHash

Penunjuk ke DWORD yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter pbHash . Saat fungsi kembali, DWORD berisi jumlah byte yang disimpan dalam buffer. Menggunakan hashing SHA1, panjang buffer yang diperlukan adalah dua puluh.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

Jika fungsi gagal, fungsi mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

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

Lihat juga

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

CryptSetKeyIdentifierProperty

Fungsi Pengidentifikasi Kunci