IcEnroll ::p ut_DeleteRequestCert, méthode (xenroll.h)

Article
03/04/2024

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

La propriété DeleteRequestCert définit ou récupère une valeur booléenne qui détermine si les certificats factices dans le magasin de requêtes sont supprimés.

Les certificats factices sont créés dans le but de rendre persistantes les clés générées pour la requête PKCS #10 pendant le processus d’inscription. Le magasin spécifié par la propriété RequestStoreName est l’emplacement où le certificat factice est créé. Les clés nouvellement générées sont ajoutées en tant que propriétés au certificat factice pour les conserver jusqu’à ce qu’une autorité de certification traite la demande et réponde avec un PKCS #7. Lors de l’acceptation du certificat PKCS #7, le certificat factice est supprimé et les clés sont ajoutées en tant que propriétés du certificat émis retourné par l’autorité de certification. Pour le débogage et le test, il est souvent souhaitable de ne pas supprimer le certificat factice. La définition de la propriété DeleteRequestCert sur FALSE empêche sa suppression.

La valeur par défaut de cette propriété est TRUE. Cette propriété a d’abord été définie dans l’interface ICEnroll .

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

Syntaxe

HRESULT put_DeleteRequestCert(
  BOOL fDelete
);

Paramètres

fDelete

Valeur de retour

None

Remarques

La propriété DeleteRequestCert affecte le comportement des méthodes suivantes :

Exemples

BOOL     bDRC;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll interface pointer.
// Get the DeleteRequestCert Boolean value.

hr = pEnroll->get_DeleteRequestCert( &bDRC );
if ( FAILED ( hr ) )
    printf("Failed getting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert: %s\n", ( bDRC ? "TRUE" : "FALSE" ) );


// Set the DeleteRequestCert value.

hr = pEnroll->put_DeleteRequestCert( FALSE );
if ( FAILED ( hr ) )
    printf("Failed Setting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert was set to FALSE\n" );

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

Partager via