Metodo ICEnroll3::get_ReuseHardwareKeyIfUnableToGenNew (xenroll.h)

  • Articolo

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà ReuseHardwareKeyIfUnableToGenNew imposta o recupera un valore booleano che determina l'azione eseguita dall'oggetto controllo di registrazione certificati se si verifica un errore durante la generazione di una nuova chiave.

Questa proprietà è stata definita per la prima volta nell'interfaccia ICEnroll3 .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_ReuseHardwareKeyIfUnableToGenNew(
  BOOL *fReuseHardwareKeyIfUnableToGenNew
);

Parametri

fReuseHardwareKeyIfUnableToGenNew

Valore restituito

nessuno

Osservazioni

Questa proprietà è un valore booleano. Questa proprietà interessa solo i provider di servizi di crittografia che restituiscono NTE_TOKEN_KEYSET_STORAGE_FULL. Questi provider di servizi di configurazione sono in genere basati su hardware; un esempio è una smart card. Se questa proprietà è true e viene rilevato un errore durante la generazione di una nuova chiave, l'oggetto controllo di registrazione certificati riutilizzerà la chiave hardware esistente. Se questa proprietà è false e viene rilevato un errore durante la generazione di una nuova chiave, l'oggetto controllo di registrazione certificati non riutilizzerà la chiave hardware esistente, ma passerà invece un errore al chiamante.

Esempio

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll

Vedi anche

CEnroll

ICEnroll3

ICEnroll4