Метод ICertPropertyFriendlyName::Initialize (certenroll.h)
Метод Initialize инициализирует объект из отображаемого имени сертификата. Этот метод поддерживается через Интернет.
Синтаксис
HRESULT Initialize(
[in] BSTR strFriendlyName
);
Параметры
[in] strFriendlyName
Переменная BSTR , содержащая имя. Длина строки не может превышать 260 символов.
Возвращаемое значение
Если функция выполнена успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
| Возвращаемый код или значение | Описание |
|---|---|
|
Объект уже инициализирован. |
|
Длина строки превышает 260 символов. |
Комментарии
Как правило, отображаемое имя указывается в пользовательском интерфейсе или из командной строки перед началом процесса регистрации, чтобы его можно было связать с фиктивным сертификатом в хранилище запросов. Чтобы получить это значение и использовать его здесь, вызовите CertificateFriendlyName в интерфейсе IX509Enrollment .
Вызовите метод SetValueOnCertificate , чтобы связать свойство с сертификатом. Вызовите свойство FriendlyName , чтобы получить отображаемое имя.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certenroll.h |
| DLL | CertEnroll.dll |