ICEnroll3：:p ut_ReuseHardwareKeyIfUnableToGenNew 方法 (xenroll.h)

[自 Windows Server 2008 和 Windows Vista 起，這個屬性不再可供使用。

ReuseHardwareKeyIfUnableToGenNew 屬性會設定或擷取布爾值，以判斷在產生新密鑰時發生錯誤時，憑證註冊控件物件所採取的動作。

此屬性最初是在 ICEnroll3 介面中定義。

這是可讀寫的屬性。

語法

HRESULT put_ReuseHardwareKeyIfUnableToGenNew(
  BOOL fReuseHardwareKeyIfUnableToGenNew
);

參數

fReuseHardwareKeyIfUnableToGenNew

傳回值

無

備註

這個屬性是布爾值。 此屬性只會影響傳回NTE_TOKEN_KEYSET_STORAGE_FULL 的密碼編譯服務提供者 。 這些 CSP 通常是以硬體為基礎的;例如智慧卡。 如果此屬性為 true 且產生新金鑰時發生錯誤，憑證註冊控制物件將會重複使用現有的硬體密鑰。 如果此屬性為 false，而且產生新金鑰時發生錯誤，憑證註冊控件物件將不會重複使用現有的硬體密鑰，而是會改為將錯誤傳遞給呼叫端。

範例

// Code to set the reuse H/W key status.
// hr is HRESULT variable.
hr = pEnroll->put_ReuseHardwareKeyIfUnableToGenNew( FALSE );
if ( FAILED( hr ) )    
    printf("Failed put_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);


// Code to retrieve the reuse H/W key status.
BOOL bReuse;

hr = pEnroll->get_ReuseHardwareKeyIfUnableToGenNew( &bReuse );
if ( FAILED( hr ) )
    printf("Failed get_ReuseHardwareKeyIfUnableToGenNew [%x]\n", hr);
else
    printf("Hardware key %s be reused if unable"
        " to generate a new key.\n", bReuse ? "will" : "will not");

規格需求

另請參閱

CEnroll

ICEnroll3

ICEnroll4