Metodo ICEnroll::p ut_RootStoreName (xenroll.h)

  • Articolo

[Questa proprietà non è più disponibile per l'uso a partire da Windows Server 2008 e Windows Vista.]

La proprietà RootStoreName imposta o recupera il nome dell'archivio radice in cui vengono mantenuti tutti i certificati radice intrinsecamente attendibili e autofirmati.

Il valore predefinito per questa proprietà è "ROOT". A causa del livello di attendibilità associato all'archivio radice, l'utente può essere richiesto (tramite l'interfaccia utente) di accettare il certificato. Anche se questa proprietà non deve essere modificata per molte applicazioni, per evitare l'interfaccia utente associata ai certificati radice attendibili, è possibile impostare RootStoreName su "CA".

Questa proprietà è stata prima definita nell'interfaccia ICEnroll .

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT put_RootStoreName(
  BSTR bstrName
);

Parametri

bstrName

Valore restituito

nessuno

Osservazioni

RootStoreName influisce sul comportamento dei metodi seguenti:

La possibilità di impostare questa proprietà è disabilitata quando viene eseguito il controllo registrazione certificati come controllo script.

Esempio

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione xenroll.h
Libreria Uuid.lib
DLL Xenroll.dll