Метод CreateSSLCertificateBinding (WMI MSReportServer_ConfigurationSetting)

Статья
06/25/2013

Создает привязку 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);

Параметры

Application
Имя приложения, для которого следует создать привязку к сертификату.
CertificateHash
Хэш для сертификата.
IPAddress
IP-адрес для приложения.
Port
Порт SSL, связанный с привязкой.
Lcid
Локаль, используемая для возвращаемых сообщений об ошибке.
Error
[out] Описание случившихся ошибок.
HRESULT
[out] Значение, которое указывает, окончился ли вызов успехом или неудачей.

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

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

Замечания

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

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

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

Сертификат не существует.
Указанный сертификат не соответствует значению, указанному для параметра IPAddress для этого компьютера.
Указанное значение параметра IPAddress является адресом категории DHCP IPAddress (изменение которого происходит периодически). Рекомендуется вместо указанного адреса использовать IP-адрес с подстановочными символами (0.0.0.0).
Указанное значение параметра IPAddress не соответствует IP-адресу, указанному в списке зарезервированных URL-адресов и не является подстановочным символом или именем хоста для существующего зарезервированного URL-адреса.
Наличие зарезервированного URL-адреса, определяющего, что имя хоста не совпадает с именем, указанным в сертификате имени хоста.

Требования

Пространство имен: корень\Microsoft\SqlServer\ReportServer\<имя_экземпляра>\v11\Admin

Платформа: Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional с пакетом обновления 2 (SP2) или с пакетом обновления 1 (SP1) либо Windows 2000 (все версии)

См. также

Справочник

Элементы MSReportServer_ConfigurationSetting

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