ICEnroll3 ::get_ReuseHardwareKeyIfUnableToGenNew, méthode (xenroll.h)

[Cette propriété n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La propriété ReuseHardwareKeyIfUnableToGenNew définit ou récupère une valeur booléenne qui détermine l’action effectuée par l’objet de contrôle d’inscription de certificat si une erreur est rencontrée lors de la génération d’une nouvelle clé.

Cette propriété a d’abord été définie dans l’interface ICEnroll3 .

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_ReuseHardwareKeyIfUnableToGenNew(
  BOOL *fReuseHardwareKeyIfUnableToGenNew
);

Paramètres

fReuseHardwareKeyIfUnableToGenNew

Valeur de retour

None

Remarques

Cette propriété est une valeur booléenne. Cette propriété affecte uniquement les fournisseurs de services de chiffrement qui retournent NTE_TOKEN_KEYSET_STORAGE_FULL. Ces fournisseurs de solutions cloud sont généralement basés sur du matériel ; un exemple est un carte intelligent. Si cette propriété a la valeur true et qu’une erreur est rencontrée lors de la génération d’une nouvelle clé, l’objet de contrôle d’inscription de certificat réutilise la clé matérielle existante. Si cette propriété est false et qu’une erreur est rencontrée lors de la génération d’une nouvelle clé, l’objet de contrôle d’inscription de certificat ne réutilisera pas la clé matérielle existante, mais transmettra une erreur à l’appelant.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll

Voir aussi

CEnroll

ICEnroll3

ICEnroll4