ICEnroll::get_DeleteRequestCert-Methode (xenroll.h)

Artikel
03/04/2024

[Diese Eigenschaft steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]

Die DeleteRequestCert-Eigenschaft legt einen booleschen Wert fest oder ruft diesen ab, der bestimmt, ob Dummyzertifikate im Anforderungsspeicher gelöscht werden.

Dummyzertifikate werden erstellt, um die schlüssel zu speichern, die für die PKCS #10-Anforderung während des Registrierungsprozesses generiert wurden. Der durch die RequestStoreName-Eigenschaft angegebene Speicher ist der Ort, an dem das Dummyzertifikat erstellt wird. Die neu generierten Schlüssel werden dem Dummyzertifikat als Eigenschaften hinzugefügt, um sie zu speichern, bis eine Zertifizierungsstelle die Anforderung verarbeitet und mit einem PKCS #7 antwortet. Bei der Annahme von PKCS #7 wird das Dummyzertifikat entfernt, und die Schlüssel werden als Eigenschaften des ausgestellten Zertifikats hinzugefügt, das von der Zertifizierungsstelle zurückgegeben wird. Zum Debuggen und Testen ist es häufig wünschenswert, das Dummyzertifikat nicht zu löschen. Wenn Sie die DeleteRequestCert-Eigenschaft auf FALSE festlegen, wird deren Löschung verhindert.

Der Standardwert für diese Eigenschaft ist TRUE. Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_DeleteRequestCert(
  BOOL *fDelete
);

Parameter

fDelete

Rückgabewert

Keine

Bemerkungen

Die DeleteRequestCert-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xenroll.h
Bibliothek	Uuid.lib
DLL	Xenroll.dll

Freigeben über