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

[Essa propriedade não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

A propriedade ReuseHardwareKeyIfUnableToGenNew define ou recupera um valor booliano que determina a ação executada pelo objeto de controle de registro de certificado se um erro for encontrado ao gerar uma nova chave.

Essa propriedade foi definida pela primeira vez na interface ICEnroll3 .

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT get_ReuseHardwareKeyIfUnableToGenNew(
  BOOL *fReuseHardwareKeyIfUnableToGenNew
);

Parâmetros

fReuseHardwareKeyIfUnableToGenNew

Valor retornado

Nenhum

Comentários

Essa propriedade é um valor booliano. Essa propriedade afeta apenas provedores de serviços criptográficos que retornam NTE_TOKEN_KEYSET_STORAGE_FULL. Esses CSPs normalmente são baseados em hardware; um exemplo é um cartão inteligente. Se essa propriedade for verdadeira e um erro for encontrado ao gerar uma nova chave, o objeto de controle de registro de certificado reutilizará a chave de hardware existente. Se essa propriedade for falsa e um erro for encontrado ao gerar uma nova chave, o objeto de controle de registro de certificado não reutilizará a chave de hardware existente, mas passará um erro para o chamador.

Exemplos

// 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 Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho xenroll.h
Biblioteca Uuid.lib
DLL Xenroll.dll

Confira também

CEnroll

ICEnroll3

ICEnroll4