ICEnroll3::p ut_ReuseHardwareKeyIfUnableToGenNew-Methode (xenroll.h)

[Diese Eigenschaft ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die ReuseHardwareKeyIfUnableToGenNew-Eigenschaft legt einen booleschen Wert fest oder ruft diesen ab, der die Aktion bestimmt, die vom Zertifikatregistrierungssteuerelementobjekt ausgeführt wird, wenn beim Generieren eines neuen Schlüssels ein Fehler auftritt.

Diese Eigenschaft wurde zuerst in der ICEnroll3-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_ReuseHardwareKeyIfUnableToGenNew(
  BOOL fReuseHardwareKeyIfUnableToGenNew
);

Parameter

fReuseHardwareKeyIfUnableToGenNew

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft ist ein boolescher Wert. Diese Eigenschaft wirkt sich nur auf Kryptografiedienstanbieter aus , die NTE_TOKEN_KEYSET_STORAGE_FULL zurückgeben. Diese CSPs sind in der Regel hardwarebasiert. Ein Beispiel hierfür ist eine intelligente Karte. Wenn diese Eigenschaft true ist und beim Generieren eines neuen Schlüssels ein Fehler auftritt, verwendet das Zertifikatregistrierungssteuerungsobjekt den vorhandenen Hardwareschlüssel wieder. Wenn diese Eigenschaft false ist und beim Generieren eines neuen Schlüssels ein Fehler auftritt, verwendet das Zertifikatregistrierungssteuerungsobjekt den vorhandenen Hardwareschlüssel nicht wieder, sondern übergibt stattdessen einen Fehler an den Aufrufer.

Beispiele

// 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");

Anforderungen

Weitere Informationen

CEnroll

ICEnroll3

ICEnroll4