ICEnroll::p ut_WriteCertToCSP-Methode (xenroll.h)

  • Artikel

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

Die WriteCertToCSP-Eigenschaft legt einen booleschen Wert fest oder ruft diesen ab, der bestimmt, ob ein Zertifikat in den Kryptografiedienstanbieter (CSP ) geschrieben werden soll.

Diese Eigenschaft wurde zuerst von der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_WriteCertToCSP(
  BOOL fBool
);

Parameter

fBool

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft wird in der Regel bei Smartcards verwendet, bei denen das Zertifikat nicht nur in den "MY"-Speicher in den smarten Karte geschrieben wird.

Der Standardwert ist true. Dies bedeutet, dass das Zertifikatregistrierungssteuerelement versucht, das Zertifikat in den CSP zu schreiben, aber nicht fehlschlägt, es sei denn, es wird ein Hardwaretokenfehler gefunden. Wenn dieser Wert true ist, aber kein smarter Karte oder ein anderer hardwareabhängiger CSP installiert ist, werden Hardwaretokenfehler ignoriert.

Um explizit zu erzwingen, dass das Zertifikatregistrierungssteuerelement nicht versucht, in den CSP zu schreiben, legen Sie diesen Wert auf false fest.

WriteCertToCSP wirkt sich auf das Verhalten der folgenden Methoden aus:

Beispiele

BOOL     bWriteCSP;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the WriteCertToCSP value
hr = pEnroll->get_WriteCertToCSP( &bWriteCSP );
if (FAILED( hr ))
    printf("Failed get_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP: %d\n", bWriteCSP );

// set the WriteCertToCSP value
hr = pEnroll->put_WriteCertToCSP( TRUE );
if (FAILED( hr ))
    printf("Failed put_WriteCertToCSP - %x\n", hr );
else
    printf( "WriteCertToCSP set to TRUE\n" );

Anforderungen

   
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