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 |