Fungsi CryptCreateKeyIdentifierFromCSP (wincrypt.h)

2024-07-16

Important 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 penyedia layanan kriptografi (CSP) kunci publikCRYPT_INTEGER_BLOB.

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

Sintaksis

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-ATAU 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 kunci publik pengidentifikasi objek (OID). Nilai yang tidak null mengambil alih OID default yang diperoleh dari aiKeyAlg anggota struktur yang ditujukkan oleh pPubKeyStruc. Untuk menggunakan OID default, atur pszPubKeyOID ke NULL.

[in] pPubKeyStruc

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

[in] cbPubKeyStruc

Ukurannya, dalam byte, dari PUBLICKEYSTRUC.

[in] dwFlags

Dicadangkan untuk penggunaan 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 publik dan pengidentifikasi kunci.

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

[in, out] pcbHash

Penunjuk ke DWORD yang menentukan ukuran, dalam byte, dari buffer yang ditujukkan 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 nonzero (TRUE).

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

Persyaratan

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

Lihat juga

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

CryptSetKeyIdentifierProperty

Fungsi Pengidentifikasi Kunci