Método ICEnroll3::get_ReuseHardwareKeyIfUnableToGenNew (xenroll.h)

  • Artículo

[Esta propiedad ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La propiedad ReuseHardwareKeyIfUnableToGenNew establece o recupera un valor booleano que determina la acción realizada por el objeto de control de inscripción de certificados si se encuentra un error al generar una nueva clave.

Esta propiedad se definió por primera vez en la interfaz ICEnroll3 .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_ReuseHardwareKeyIfUnableToGenNew(
  BOOL *fReuseHardwareKeyIfUnableToGenNew
);

Parámetros

fReuseHardwareKeyIfUnableToGenNew

Valor devuelto

None

Observaciones

Esta propiedad es un valor booleano. Esta propiedad afecta solo a los proveedores de servicios criptográficos que devuelven NTE_TOKEN_KEYSET_STORAGE_FULL. Estos CSP suelen basarse en hardware; un ejemplo es una tarjeta inteligente. Si esta propiedad es true y se produce un error al generar una nueva clave, el objeto de control de inscripción de certificados reutilizará la clave de hardware existente. Si esta propiedad es false y se produce un error al generar una nueva clave, el objeto de control de inscripción de certificados no reutilizará la clave de hardware existente, sino que pasará un error al autor de la llamada.

Ejemplos

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado xenroll.h
Library Uuid.lib
Archivo DLL Xenroll.dll

Consulte también

CEnroll

ICEnroll3

ICEnroll4