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

Artikel
03/13/2024

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

Die RequestStoreName-Eigenschaft legticEnroll den Namen des Speichers fest, der das Dummyzertifikat enthält, oder ruft diesen ab. Dieses Dummyzertifikat bleibt zusammen mit den hinzugefügten privaten Schlüsseln im Anforderungsspeicher, bis eine Zertifizierungsstelle die Anforderung verarbeitet und mit einem PKCS #7 antwortet.

Der Standardwert für diese Eigenschaft ist "REQUEST". Wenn der Standardwert nicht verwendet werden soll, muss diese Eigenschaft auf den Speicher festgelegt werden, der vor Aufrufen von createPKCS10 oder createFilePKCS10 und erneut vor Aufrufen von acceptPKCS7 oder acceptFilePKCS7 verwendet werden soll.

Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_RequestStoreName(
  BSTR bstrName
);

Parameter

bstrName

Rückgabewert

Keine

Bemerkungen

In der Regel wird die Änderung der RequestStoreName-Eigenschaft nur in erweiterten Anwendungen durchgeführt. Das Ändern dieses Werts wird für die meisten Anwendungen nicht empfohlen.

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

Die Möglichkeit, diese Eigenschaft festzulegen, ist deaktiviert, wenn das Zertifikatregistrierungssteuerelement als skriptbasiertes Steuerelement ausgeführt wird.

Beispiele

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

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