Metodo ICEnroll::get_RootStoreName (xenroll.h)

[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 get_RootStoreName(
  BSTR *pbstrName
);

Parametri

pbstrName

Valore restituito

nessuno

Osservazioni

RootStoreName influisce sul comportamento dei metodi seguenti:

• acceptPKCS7
• acceptFilePKCS7

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