Метод ICEnroll::p ut_GenKeyFlags (xenroll.h)

Статья
03/04/2024

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

Свойство GenKeyFlags задает или извлекает значения, передаваемые в функцию CryptGenKey при создании запроса на сертификат.

По умолчанию свойство GenKeyFlags равно нулю. Однако при указании PVK-файла значение GenKeyFlags по умолчанию CRYPT_EXPORTABLE. Дополнительные сведения см. в подразделе "Примечания".

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

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

Синтаксис

HRESULT put_GenKeyFlags(
  LONG dwFlags
);

Параметры

dwFlags

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

None

Remarks

По умолчанию закрытые ключи не экспортируются, если не запрашивается PVK-файл. Чтобы сделать закрытый ключ экспортируемым без указания PVK-файла, задайте для GenKeyFlags значение CRYPT_EXPORTABLE.

Чтобы указать имя PVK-файла, используйте свойство PVKFileName .

Значение свойства GenKeyFlags передается в функцию CryptGenKey CryptoAPI с помощью ее параметра dwFlags .

Если поставщик служб шифрования (CSP) не поддерживает экспортируемые закрытые ключи, возникает ошибка.

Свойство GenKeyFlags влияет на поведение следующих методов:

Примечание Значение по умолчанию для свойства GenKeyFlags равно нулю. Если необходимо изменить это значение, это необходимо сделать перед вызовом этих методов. После вызова любого из этих методов нельзя изменить значение свойства GenKeyFlags .

Примеры

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

Требования

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