Condividi tramite

Metodo di ConfigurationSetting - CreateSSLCertificateBinding

  • Articolo

Crea un'associazione di certificati TLS/SSL.

Sintassi

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

Parametri

Applicazione
Nome dell'applicazione per la quale l'associazione certificato deve essere creata.

CertificateHash
Hash per il certificato. CertificateHash prevede un hash minuscolo. Se l'hash contiene caratteri maiuscoli, l'operazione ha esito negativo.

IPAddress
Indirizzo IP per l'applicazione.

Porta
Porta TLS associata all'associazione.

LCID
Impostazioni locali da utilizzare per i messaggi di errore restituiti.

Errore
[out] Descrizione degli errori che si sono verificati.

HRESULT
[out] Valore che indica se la chiamata ha avuto esito positivo o negativo.

Valore restituito

Restituisce un HRESULT che indica l'esito positivo o negativo della chiamata al metodo. Il valore 0 indica l'esito positivo della chiamata al metodo, mentre un codice di errore ne indica l'esito negativo.

Osservazioni:

Questo metodo aggiunge un'associazione a rsreportserver.config per l'applicazione. Se in HTTP.SYS non esiste già un'associazione, ne viene creata una.

Prima venga creata l'associazione, la chiamata al metodo esamina le prenotazioni dell'URL affinché l'applicazione specificata determini se l'associazione di certificati TLS/SSL è valida.

Le condizioni seguenti vengono convalidate e possono causare errori:

  1. Il certificato non esiste.

  2. Il valore IPAddress specificato non corrisponde al valore IPAddress di questo computer.

  3. Il valore IPAddress specificato è un IPAddress DHCP (che cambia periodicamente). Usare invece l'indirizzo IP con caratteri jolly (0.0.0.0).

  4. Il valore IPAddress specificato non corrisponde all'indirizzo IP di una prenotazione URL E non esiste né un carattere jolly né la prenotazione URL del nome host.

  5. Esiste una prenotazione URL che specifica un nome host, ma il nome host non corrisponde al nome host del certificato.

Requisiti

Spazio dei nomi: root\Microsoft\SqlServer\ReportServer\<InstanceName>\v13\Admin

Contenuto correlato