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

Метод CreateSSLCertificateBinding (WMI MSReportServer_ConfigurationSetting)

  • Статья

Создает привязку SSL-сертификата.

Синтаксис

Public Sub CreateSSLCertificateBinding(ByVal Application As String, _  
    ByVal CertificateHash As String, ByVal IPAddress As String, _  
    ByVal Port As Int32, ByVal lcid As Int32, _  
    ByRef [Error] As String, ByRef HRESULT As Int32)  

public void CreateSSLCertificateBinding(string application,   
    string certificateHash, string IPAddress, int Port,   
    int lcid, out string error, out int HRESULT);

Параметры

Приложение
Имя приложения, для которого следует создать привязку к сертификату.

CertificateHash
Хэш для сертификата.

IPAddress
IP-адрес для приложения.

порт.
Порт SSL, связанный с привязкой.

Код языка
Локаль, используемая для возвращаемых сообщений об ошибке.

Ошибка
[out] Описание случившихся ошибок.

HRESULT
[out] Значение, которое указывает, окончился ли вызов успехом или сбоем.

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

Возвращает значение HRESULT , являющееся признаком успешного или неуспешного завершение вызова метода. Значение 0 означает, что вызов метода завершился успешно; код ошибки означает, что произошла ошибка.

Замечания

Этот метод позволяет добавить привязку приложения в файл rsreportserver.config. Если привязка еще не существует в файле HTTP.SYS, то она в нем создается.

Перед созданием привязки при вызове метода происходит проверка зарезервированных URL-адресов для того, чтобы указанное приложение могло определить допустимость привязки сертификата SSL.

Выполняется проверка следующих условий, результатом которой могут стать ошибки.

  1. Сертификат не существует.

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

  3. Указанное значение параметра IPAddress является адресом категории DHCP IPAddress (изменение которого происходит периодически). Рекомендуется вместо указанного адреса использовать IP-адрес с подстановочными символами (0.0.0.0).

  4. Указанное значение параметра IPAddress не соответствует IP-адресу, указанному в списке зарезервированных URL-адресов и не является подстановочным символом или именем хоста для существующего зарезервированного URL-адреса.

  5. Наличие зарезервированного URL-адреса, определяющего, что имя хоста не совпадает с именем, указанным в сертификате имени хоста.

Требования

Пространство имен: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v12\Admin

См. также

Элементы MSReportServer_ConfigurationSetting