Artigo
09/28/2010

Método CreateSSLCertificateBinding (WMI MSReportServer_ConfigurationSetting)

Cria uma associação de Certificado SSL.

Sintaxe

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);

Parâmetros

Application
O nome do aplicativo para o qual a associação de certificado deve ser criada.
CertificateHash
O hash para o certificado.
IPAddress
O endereço IP para o aplicativo.
Port
A porta SSL relacionada à associação.
Lcid
A localidade a ser usada para as mensagens de erro retornadas.
Error
[fora] A descrição dos erros ocorridos.
HRESULT
[fora] Valor que indica se a chamada teve sucesso ou falhou.

Valor de retorno

Retorna um HRESULT indicando êxito ou falha da chamada do método. Um valor 0 indica que a chamada do método foi bem-sucedida; um código de erro indica que a chamada não foi bem-sucedida.

Comentários

Este método adiciona uma associação a rsreportserver.config para o aplicativo. Caso ainda não exista uma associação em HTTP.SYS, ela será criada ali.

Antes de criar a associação, a chamada do método examina as Reservas de Url referentes ao aplicativo especificado a fim de determinar se a Associação de Certificado SSL é válida.

As seguintes condições são validadas e podem resultar em erros:

O certificado não existe.
O valor IPAddress especificado não corresponde a um IPAddress deste computador.
O IPAddress especificado é um IPAddress DHCP (muda periodicamente) – no lugar dele, use o endereço IP Curinga (0.0.0.0).
O IPAddress especificado não corresponde ao endereço IP de uma reserva de URL, tampouco existe uma reserva de URL com nome de host ou curinga.
Uma reserva de URL que especifica que existe um nome de host, mas o nome de host não corresponde ao nome de host do certificado.

Requisitos

Namespace: raiz\Microsoft\SqlServer\ReportServer\RS_<Nome_da_Instância_Codificado>\v10\Admin

**Plataforma:**Windows Server 2003, Datacenter Edition; Windows Server 2003, Enterprise Edition; Windows Server 2003, Standard Edition; Windows Vista; Windows XP Professional com Service Pack 2 (SP2) ou Service Pack 1 (SP1); ou Windows 2000 (todas as versões)

Consulte também

Referência

Membros MSReportServer_ConfigurationSetting

Compartilhar via