ICEnroll::get_RootStoreName méthode (xenroll.h)

Article
08/28/2023

[Cette propriété n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La propriété RootStoreName définit ou récupère le nom du magasin racine où tous les certificats racine auto-signés de confiance intrinsèquement sont conservés.

La valeur par défaut de cette propriété est « ROOT ». En raison du niveau de confiance associé au magasin racine, l’utilisateur peut être invité (au moyen de l’interface utilisateur) à accepter le certificat. Bien que cette propriété n’ait pas besoin d’être modifiée pour de nombreuses applications, pour éviter l’interface utilisateur associée à l’approbation des certificats racines, il est possible de définir RootStoreName sur « CA ».

Cette propriété a d’abord été définie dans l’interface ICEnroll .

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_RootStoreName(
  BSTR *pbstrName
);

Paramètres

pbstrName

Valeur de retour

None

Remarques

RootStoreName affecte le comportement des méthodes suivantes :

La possibilité de définir cette propriété est désactivée lorsque le contrôle d’inscription de certificat est exécuté en tant que contrôle scripté.

Exemples

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

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll

Partager via