Método ICEnroll::get_RootStoreName (xenroll.h)
[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 de confianza intrínsecamente autofirmados.
El valor predeterminado de esta propiedad es "ROOT". Debido al nivel de confianza asociado al almacén raíz, se puede solicitar al usuario (mediante 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, existe la posibilidad de establecer RootStoreName en "CA".
Esta propiedad se definió por primera vez en la interfaz ICEnroll .
Esta propiedad es de lectura y escritura.
Sintaxis
HRESULT get_RootStoreName(
BSTR *pbstrName
);
Parámetros
pbstrName
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
| 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 |