Método ICEnroll3::p ut_ReuseHardwareKeyIfUnableToGenNew (xenroll.h)
[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 put_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 estar basados 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 |