ICEnroll：:p ut_GenKeyFlags 方法 (xenroll.h)
[从 Windows Server 2008 和 Windows Vista 起，此属性不再可供使用。]
生成证书请求时 ，GenKeyFlags 属性设置或检索传递给 CryptGenKey 函数的值。
默认情况下， GenKeyFlags 属性设置为零。 但是，指定 .pvk 文件时， GenKeyFlags 的值默认为 CRYPT_EXPORTABLE。 有关详细信息，请参阅“备注”。
此属性首先在 ICEnroll 接口中定义。
此属性是可读写的。
语法
HRESULT put_GenKeyFlags(
LONG dwFlags
);
参数
dwFlags
返回值
无
备注
默认情况下，除非请求 .pvk 文件，否则私钥不可导出。 若要在不指定 .pvk 文件的情况下使私钥可导出，请将 GenKeyFlags 设置为 CRYPT_EXPORTABLE。
若要指定 .pvk 文件名，请使用 PVKFileName 属性。
GenKeyFlags 属性值通过使用其 dwFlags 参数传递给 CryptGenKey CryptoAPI 函数。
如果 加密服务提供程序 (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 |
| 标头 | xenroll.h |
| Library | Uuid.lib |
| DLL | Xenroll.dll |