Metode ICEnroll3::p ut_LimitExchangeKeyToEncipherment (xenroll.h)

Artikel
08/28/2023

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

Properti LimitExchangeKeyToEncipherment menetapkan atau mengambil nilai Boolean yang menentukan apakah permintaan AT_KEYEXCHANGE berisi tanda tangan digital dan penggunaan kunci nonrepudiasi.

Properti ini pertama kali diperkenalkan di antarmuka ICEnroll3 .

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_LimitExchangeKeyToEncipherment(
  BOOL fLimitExchangeKeyToEncipherment
);

Parameter

fLimitExchangeKeyToEncipherment

Menampilkan nilai

Tidak ada

Keterangan

Properti ini adalah nilai Boolean dan hanya memengaruhi permintaan AT_KEYEXCHANGE. Ini tidak berdampak pada permintaan AT_SIGNATURE.

Jika nilai untuk properti ini salah, permintaan AT_KEYEXCHANGE akan berisi penggunaan kunci berikut:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE

Jika nilai untuk properti ini benar, permintaan AT_KEYEXCHANGE akan berisi penggunaan kunci berikut:

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE

Contoh

// Get the LimitExchangeKeyToEncipherment value.
BOOL       bLimitKey;
HRESULT    hr;
// pEnroll is previously instantiated ICEnroll interface pointer.
hr = pEnroll->get_LimitExchangeKeyToEncipherment(&bLimitKey);
if (FAILED(hr))
    printf("Failed get_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf("LimitExchangeKeyToEncipherment: %s\n",
          ( bLimitKey ? "TRUE" : "FALSE"));

// Set the LimitExchangeKeyToEncipherment value.
hr = pEnroll->put_LimitExchangeKeyToEncipherment( TRUE );
if ( FAILED ( hr ) )
    printf("Failed put_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf( "LimitExchangeKeyToEncipherment was set to TRUE\n" );

Persyaratan


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

Lihat juga

Bagikan melalui