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

Статья
03/04/2024

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

Свойство ReuseHardwareKeyIfUnableToGenNew задает или извлекает логическое значение, определяющее действие, выполняемое объектом элемента управления регистрации сертификатов, если при создании нового ключа возникает ошибка.

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

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

Синтаксис

HRESULT get_ReuseHardwareKeyIfUnableToGenNew(
  BOOL *fReuseHardwareKeyIfUnableToGenNew
);

Параметры

fReuseHardwareKeyIfUnableToGenNew

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

None

Remarks

Это свойство является логическим значением. Это свойство влияет только на поставщиков служб шифрования , которые возвращают NTE_TOKEN_KEYSET_STORAGE_FULL. Эти поставщики служб конфигурации обычно основаны на оборудовании; Примером является смарт-карта. Если это свойство имеет значение true и при создании нового ключа возникает ошибка, объект управления регистрацией сертификатов будет повторно использовать существующий аппаратный ключ. Если это свойство имеет значение false и при создании нового ключа возникает ошибка, объект управления регистрации сертификатов не будет повторно использовать существующий аппаратный ключ, а вместо этого передает ошибку вызывающей объекту.

Примеры

// Code to set the reuse H/W key status.
// hr is HRESULT variable.
hr = pEnroll->put_ReuseHardwareKeyIfUnableToGenNew( FALSE );
if ( FAILED( hr ) )    
    printf("Failed put_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);


// Code to retrieve the reuse H/W key status.
BOOL bReuse;

hr = pEnroll->get_ReuseHardwareKeyIfUnableToGenNew( &bReuse );
if ( FAILED( hr ) )
    printf("Failed get_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);
else
    printf("Hardware key %s be reused if unable"
        " to generate a new key.\n", bReuse ? "will" : "will not");

Требования

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

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

CEnroll

ICEnroll3

ICEnroll4

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