Metode ICEnroll::p ut_GenKeyFlags (xenroll.h)

Artikel
03/08/2023

[Properti ini tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Properti GenKeyFlags menetapkan atau mengambil nilai yang diteruskan ke fungsi CryptGenKey saat permintaan sertifikat dibuat.

Secara default, properti GenKeyFlags diatur ke nol. Namun, ketika file .pvk ditentukan, nilai GenKeyFlags default ke CRYPT_EXPORTABLE. Untuk informasi selengkapnya, lihat Keterangan.

Properti ini pertama kali didefinisikan dalam antarmuka ICEnroll .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_GenKeyFlags(
  LONG dwFlags
);

Parameter

dwFlags

Nilai kembali

Tidak ada

Keterangan

Secara default, kunci privat tidak dapat diekspor kecuali file .pvk diminta. Agar kunci privat dapat diekspor tanpa menentukan file .pvk, atur GenKeyFlags ke CRYPT_EXPORTABLE.

Untuk menentukan nama file .pvk, gunakan properti PVKFileName .

Nilai properti GenKeyFlags diteruskan ke fungsi CryptGenKey CryptoAPI dengan menggunakan parameter dwFlags-nya .

Jika penyedia layanan kriptografi (CSP) tidak mendukung kunci privat yang dapat diekspor, kesalahan terjadi.

Properti GenKeyFlags memengaruhi perilaku metode berikut:

Catatan Nilai default untuk properti GenKeyFlags adalah nol. Jika Anda perlu mengubah nilai ini, Anda harus melakukannya sebelum memanggil metode ini. Setelah memanggil salah satu metode ini, Anda tidak dapat mengubah nilai properti GenKeyFlags .

Contoh

LONG     lGenKey;
HRESULT  hr;

// pEnroll is a previously instantiated ICEnroll interface pointer.

// Get the GenKeyFlags value.
hr = pEnroll->get_GenKeyFlags( &lGenKey );
if (FAILED( hr ))
    printf("Failed get_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags: %d\n", lGenKey );

// Set the GenKeyFlags value.
hr = pEnroll->put_GenKeyFlags( CRYPT_EXPORTABLE );
if (FAILED( hr ))
    printf("Failed put_GenKeyFlags - %x\n", hr );
else
    printf( "GenKeyFlags set to %d\n", CRYPT_EXPORTABLE );

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	xenroll.h
Pustaka	Uuid.lib
DLL	Xenroll.dll