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

  • Artikel

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

Mit der RootStoreName-Eigenschaft wird der Name des Stammspeichers festgelegt oder abgerufen, in dem alle intrinsisch vertrauenswürdigen, selbstsignierten Stammzertifikate aufbewahrt werden.

Der Standardwert für diese Eigenschaft ist "ROOT". Aufgrund der dem Stammspeicher zugeordneten Vertrauensstufe wird der Benutzer möglicherweise (über die Benutzeroberfläche) aufgefordert, das Zertifikat zu akzeptieren. Obwohl diese Eigenschaft für viele Anwendungen nicht geändert werden muss, besteht die Möglichkeit, RootStoreName auf "CA" festzulegen, um die Benutzeroberfläche zu vermeiden, die mit vertrauenswürdigen Stammzertifikaten verknüpft ist.

Diese Eigenschaft wurde zuerst in der ICEnroll-Schnittstelle definiert.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_RootStoreName(
  BSTR bstrName
);

Parameter

bstrName

Rückgabewert

Keine

Bemerkungen

RootStoreName 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_RootStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName: %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_RootStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName 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