IEnroll2::put_ReuseHardwareKeyIfUnableToGenNew method (xenroll.h)

[This property is no longer available for use as of Windows Server 2008 and Windows Vista.]

The ReuseHardwareKeyIfUnableToGenNew property sets or retrieves a Boolean value that determines the action taken by the certificate enrollment control object if an error is encountered when generating a new key.

This property was first defined in the IEnroll2 interface.

This property is read/write.

Syntax

HRESULT put_ReuseHardwareKeyIfUnableToGenNew(
  BOOL fReuseHardwareKeyIfUnableToGenNew
);

Parameters

fReuseHardwareKeyIfUnableToGenNew

Return value

None

Remarks

This property is a Boolean value. This property affects only cryptographic service providers (CSP) that return NTE_TOKEN_KEYSET_STORAGE_FULL. These CSPs are typically hardware-based; an example is a smart card. If this property is TRUE and an error is encountered while generating a new key, the certificate enrollment control object will reuse the existing hardware key. If this property is FALSE and an error is encountered while generating a new key, the certificate enrollment control object will not reuse the existing hardware key but will instead pass an error to the caller.

Requirements

See also

IEnroll2

IEnroll4