Метод IX500DistinguishedName::Encode (certenroll.h)
Метод Encode инициализирует объект из строки, содержащей различающееся имя. Этот метод поддерживается через Интернет.
Синтаксис
HRESULT Encode(
[in] BSTR strName,
[in] X500NameFlags NameFlags
);
Параметры
[in] strName
Переменная BSTR , содержащая строку для кодирования.
[in] NameFlags
Значение перечисления X500NameFlags , указывающее формат закодированного значения.
- Значение по умолчанию, указанное в Certenroll.h, — XCN_CERT_NAME_STR_NONE.
- Если не указать XCN_CERT_NAME_STR_FORWARD_FLAG, XCN_CERT_NAME_STR_REVERSE_FLAG применяется автоматически.
- Если XCN_CERT_NAME_STR_DISABLE_UTF8_DIR_STR_FLAG не указан, XCN_CERT_NAME_STR_FORCE_UTF8_DIR_STR_FLAG применяется автоматически.
- XCN_CERT_NAME_STR_ENABLE_PUNYCODE_FLAG устанавливается автоматически независимо от другого указанного флага.
Возвращаемое значение
Если функция выполнена успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Возвращаемый код или значение | Описание |
---|---|
|
Не удалось выделить память для закодированного значения. |
|
Параметр strName не может иметь значение NULL. |
|
Длина в символах параметра strName не может превышать 64 * 1024. |
Комментарии
Этот метод вызывает функцию CertStrToName CryptoAPI. Вызовите свойство Name , чтобы получить имя в виде символьной строки с пустым завершением. Вызовите свойство EncodedName , чтобы получить строку, содержащую закодированное имя.
Требования
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Целевая платформа | Windows |
Header | certenroll.h |
DLL | CertEnroll.dll |