Método ICEnroll::p ut_RootStoreName (xenroll.h)

  • Artículo

[Esta propiedad ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La propiedad RootStoreName establece o recupera el nombre del almacén raíz donde se conservan todos los certificados raíz autofirmados y de confianza intrínseca.

El valor predeterminado de esta propiedad es "ROOT". Debido al nivel de confianza asociado al almacén raíz, se puede pedir al usuario (por medio de la interfaz de usuario) que acepte el certificado. Aunque no es necesario cambiar esta propiedad para muchas aplicaciones, para evitar la interfaz de usuario asociada a certificados raíz de confianza, es posible establecer RootStoreName en "CA".

Esta propiedad se definió por primera vez en la interfaz ICEnroll .

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT put_RootStoreName(
  BSTR bstrName
);

Parámetros

bstrName

Valor devuelto

None

Observaciones

RootStoreName afecta al comportamiento de los métodos siguientes:

La capacidad de establecer esta propiedad está deshabilitada cuando el control de inscripción de certificados se ejecuta como un control con script.

Ejemplos

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado xenroll.h
Library Uuid.lib
Archivo DLL Xenroll.dll