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

傳回值

無

備註

根據預設，除非要求 .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