Метод IAlternativeName::InitializeFromString (certenroll.h)
Метод InitializeFromString инициализирует объект из строки, содержащей адрес электронной почты, dns-имя, URL-адрес, идентификатор зарегистрированного объекта (OID) или имя участника-пользователя (UPN).
Синтаксис
HRESULT InitializeFromString(
[in] AlternativeNameType Type,
[in] BSTR strValue
);
Параметры
[in] Type
Значение перечисления AlternativeNameType , определяющее тип имени, представленного входной строкой, содержащейся в параметре strValue . Это должно быть одно из следующих значений.
[in] strValue
Переменная BSTR , содержащая имя.
Возвращаемое значение
Если функция выполнена успешно, функция возвращает S_OK.
Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.
Комментарии
Если этот метод используется для указания имени участника-пользователя, имя участника-пользователя связывается с идентификатором XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) и Distinguished Encoding Rules кодируется (DER). Чтобы получить закодированный массив байтов, можно вызвать свойство RawData . OID можно получить, вызвав свойство ObjectId .
Если этот метод используется для указания любого из следующих типов имен, метод возвращает E_INVALIDARG.
| Значение | Описание |
|---|---|
| XCN_CERT_ALT_NAME_UNKNOWN | Тип имени не идентифицируется. |
| XCN_CERT_ALT_NAME_OTHER_NAME | Имя состоит из OID и массива байтов. |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | Это имя каталога X.500 . |
| XCN_CERT_ALT_NAME_IP_ADDRESS | Имя является IP-адресом. |
| XCN_CERT_ALT_NAME_GUID | Имя — guid. |
Вы можете использовать метод InitializeFromOtherName , чтобы указать OID и соответствующую строку имени, а метод InitializeFromRawData — для указания GUID, IP-адреса или имени каталога X.500.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | certenroll.h |
| DLL | CertEnroll.dll |