Fungsi CryptSetKeyIdentifierProperty (wincrypt.h)

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 CryptSetKeyIdentifierProperty mengatur properti pengidentifikasi kunci tertentu. Fungsi ini dapat mengatur properti pada komputer yang diidentifikasi dalam pwszComputerName.

Sintaks

BOOL CryptSetKeyIdentifierProperty(
  [in]  const CRYPT_HASH_BLOB *pKeyIdentifier,
  [in]  DWORD                 dwPropId,
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pwszComputerName,
  [in]  void                  *pvReserved,
  [out] const void            *pvData
);

Parameter

[in] pKeyIdentifier

Penunjuk ke CRYPT_HASH_BLOB yang berisi pengidentifikasi kunci.

[in] dwPropId

Mengidentifikasi properti yang akan diatur. Nilai dwPropId menentukan jenis dan konten parameter pvData . ID properti sertifikat apa pun dapat digunakan. CERT_KEY_PROV_INFO_PROP_ID adalah properti yang paling diminati.

[in] dwFlags

Bendera berikut dapat diatur. Mereka dapat dikombinasikan dengan operasi bitwise-OR.

Nilai	Makna
CRYPT_KEYID_MACHINE_FLAG	Mengatur properti LocalMachine (jika pwszComputerName adalah NULL) atau komputer jarak jauh (jika pwszComputerName bukan NULL). Untuk informasi selengkapnya, lihat pwszComputerName.
CRYPT_KEYID_DELETE_FLAG	Pengidentifikasi kunci dan semua propertinya dihapus.
CRYPT_KEYID_SET_NEW_FLAG	Mengatur properti pengidentifikasi kunci baru. Jika properti sudah ada, upaya gagal, dan FALSE dikembalikan dengan kode kesalahan terakhir yang diatur ke CRYPT_E_EXISTS.

[in] pwszComputerName

Penunjuk ke string yang dihentikan null yang berisi nama komputer jarak jauh yang memiliki pengidentifikasi kunci tempat properti diatur. Jika bendera CRYPT_KEYID_MACHINE_FLAG diatur, cari komputer jarak jauh untuk daftar pengidentifikasi kunci. Jika komputer lokal akan diatur dan bukan komputer jarak jauh, atur pwszComputerName ke NULL.

[in] pvReserved

Dicadangkan untuk digunakan di masa mendatang dan harus NULL.

[out] pvData

Jika dwPropId CERT_KEY_PROV_INFO_PROP_ID, pvData menunjuk ke struktur CRYPT_KEY_PROV_INFO yang berisi properti pengidentifikasi kunci.

Jika dwPropId tidak CERT_KEY_PROV_INFO_PROP_ID, pvData menunjuk ke struktur CRYPT_DATA_BLOB yang berisi properti pengidentifikasi kunci.

Mengatur pvData ke NULL akan menghapus properti .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol (TRUE).

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

Catatan Jika CRYPT_KEYID_SET_NEW_FLAG diatur dan properti sudah ada, FALSE dikembalikan dengan kode kesalahan terakhir yang diatur ke CRYPT_E_EXISTS.

 

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

Fungsi Pengidentifikasi Kunci