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

Статья
08/28/2023

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

Свойство RequestStoreName задает или извлекаетICEnroll имя хранилища, содержащего фиктивный сертификат. Этот фиктивный сертификат вместе с добавленными закрытыми ключами остается в хранилище запросов до тех пор, пока центр сертификации не обработает запрос и не ответит PKCS 7.

Значение по умолчанию для этого свойства — REQUEST. Если значение по умолчанию не используется, для этого свойства необходимо задать хранилище, которое будет использоваться перед вызовами createPKCS10 или createFilePKCS10 и снова перед вызовами acceptPKCS7 или acceptFilePKCS7.

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

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT get_RequestStoreName(
  BSTR *pbstrName
);

Параметры

pbstrName

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

None

Remarks

Как правило, изменение свойства RequestStoreName выполняется только в расширенных приложениях. Изменять это значение не рекомендуется для большинства приложений.

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

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

Примеры

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RequestStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName: %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_RequestStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RequestStoreName - %x\n", hr );
else
    printf( "RequestStoreName was set to : %ws\n", bstrNewName );

Требования


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

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