Метод ICEnroll::p ut_RootStoreName (xenroll.h)

Статья
03/04/2024

[Это свойство больше не доступно для использования в Windows Server 2008 и Windows Vista.]

Свойство RootStoreName задает или извлекает имя корневого хранилища, в котором хранятся все внутренние доверенные самозаверяемые корневые сертификаты .

Значение по умолчанию для этого свойства — ROOT. Из-за уровня доверия, связанного с корневым хранилищем, пользователю может быть предложено (с помощью пользовательского интерфейса) принять сертификат. Хотя это свойство не требуется изменять для многих приложений, чтобы избежать пользовательского интерфейса, связанного с доверенными корневыми сертификатами, можно задать для RootStoreName значение "CA".

Это свойство было впервые определено в интерфейсе ICEnroll .

Это свойство является чтением и записью.

Синтаксис

HRESULT put_RootStoreName(
  BSTR bstrName
);

Параметры

bstrName

Возвращаемое значение

None

Remarks

RootStoreName влияет на поведение следующих методов:

Возможность задания этого свойства отключается, когда элемент управления регистрации сертификатов выполняется как элемент управления с помощью скрипта.

Примеры

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	xenroll.h
Библиотека	Uuid.lib
DLL	Xenroll.dll

Поделиться через