Метод IX509AttributeOSVersion::InitializeEncode (certenroll.h)
Метод InitializeEncode инициализирует атрибут из сведений о версии операционной системы.
Синтаксис
HRESULT InitializeEncode(
[in, optional] BSTR strOSVersion
);
Параметры
[in, optional] strOSVersion
Переменная BSTR , содержащая сведения о версии. Формат строки — major.minor.build.platform. Этот параметр является необязательным. Если строка не указана, этот метод вызывает функцию GetVersionEx .
Возвращаемое значение
Если функция выполнена успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
Идентификатор объекта (OID) для этого атрибута XCN_OID_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Дополнительные сведения см. в разделе CERTENROLL_OBJECTID.
Прежде чем использовать объект IX509AttributeOSVersion, необходимо вызвать InitializeEncode или InitializeDecode. Эти два метода дополняют друг друга. Метод InitializeEncode позволяет создать закодированную структуру абстрактного синтаксиса (ASN.1) из необработанных данных, а метод InitializeDecode позволяет инициализировать необработанные данные из закодированной структуры ASN.1. Чтобы получить необработанные данные, можно вызвать свойство OSVersion .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certenroll.h |
| DLL | CertEnroll.dll |