ICEnroll：:p ut_GenKeyFlags 方法 (xenroll.h)

發行項
03/13/2024

[自 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
程式庫	Uuid.lib
Dll	Xenroll.dll