SslStream.BeginAuthenticateAsClient Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia un'operazione per autenticare il lato client di una connessione client-server.
Overload
| Nome | Descrizione |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati specificati e il protocollo di sicurezza predefinito del sistema. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati e il protocollo di sicurezza specificati. |
Commenti
Gli overload di questo metodo non bloccano mentre è in corso l'autenticazione. Per bloccare l'attesa del completamento dell'autenticazione, usare uno dei AuthenticateAsClient metodi .
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
targetHost è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows). Nell'autenticazione non vengono usati certificati client. L'elenco di revoche di certificati non viene controllato durante l'autenticazione.
Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsClient metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.
Si applica a
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati specificati e il protocollo di sicurezza predefinito del sistema.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- clientCertificates
- X509CertificateCollection
Oggetto X509CertificateCollection contenente i certificati client.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
targetHost è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).
Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsClient metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.
Note
I certificati client non sono supportati nel protocollo SSL versione 2.
Si applica a
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai client per avviare un'operazione asincrona per autenticare il server e facoltativamente il client usando i certificati e il protocollo di sicurezza specificati.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultParametri
- clientCertificates
- X509CertificateCollection
Oggetto X509CertificateCollection contenente i certificati client.
- enabledSslProtocols
- SslProtocols
Valore SslProtocols che rappresenta i protocolli utilizzati per l'autenticazione.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
- asyncCallback
- AsyncCallback
Delegato AsyncCallback che fa riferimento al metodo da richiamare al termine dell'autenticazione.
- asyncState
- Object
Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al asyncCallback delegato al termine dell'operazione.
Valori restituiti
Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.
Eccezioni
targetHost è null.
enabledSslProtocols non è un valore valido SslProtocols .
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo oggetto è stato chiuso.
Commenti
A partire da .NET Framework 4.7, questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).
Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.
L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.
Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, utilizzare uno degli overload del AuthenticateAsClient metodo.
Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni
Se si riceve un oggetto AuthenticationException, non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti a esso in modo che possa essere raccolto dal Garbage Collector.
Note
I certificati client non sono supportati nel protocollo SSL versione 2.
