Поделиться через


Метод ICEnroll3::get_LimitExchangeKeyToEncipherment (xenroll.h)

[Это свойство больше не доступно для использования в Windows Server 2008 и Windows Vista.]

Свойство LimitExchangeKeyToEncipherment задает или извлекает логическое значение, которое определяет, содержит ли запрос AT_KEYEXCHANGE цифровую подпись и использование ключей без восстановления.

Это свойство впервые появилось в интерфейсе ICEnroll3 .

Это свойство является чтением и записью.

Синтаксис

HRESULT get_LimitExchangeKeyToEncipherment(
  BOOL *fLimitExchangeKeyToEncipherment
);

Параметры

fLimitExchangeKeyToEncipherment

Возвращаемое значение

None

Remarks

Это свойство является логическим значением и влияет только на AT_KEYEXCHANGE запросов. Это не влияет на запросы AT_SIGNATURE.

Если для этого свойства задано значение false, запрос AT_KEYEXCHANGE будет содержать следующие значения использования ключей:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE
  • CERT_DIGITAL_SIGNATURE_KEY_USAGE
  • CERT_NON_REPUDIATION_KEY_USAGE

Если для этого свойства задано значение true, запрос AT_KEYEXCHANGE будет содержать следующие варианты использования ключей:

  • CERT_DATA_ENCIPHERMENT_KEY_USAGE
  • CERT_KEY_ENCIPHERMENT_KEY_USAGE

Примеры

// 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" );

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header xenroll.h
Библиотека Uuid.lib
DLL Xenroll.dll

См. также раздел

CEnroll

ICEnroll3

ICEnroll4

KeySpec