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

Статья
08/28/2023

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

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

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

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT get_GenKeyFlags(
  LONG *pdwFlags
);

Параметры

pdwFlags

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

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