SslStream.BeginAuthenticateAsClient Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Påbörjar en åtgärd för att autentisera klientsidan för en klient-server-anslutning.
Överlagringar
| Name | Description |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten med hjälp av de angivna certifikaten och systemets standardsäkerhetsprotokoll. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten med hjälp av de angivna certifikaten och säkerhetsprotokollet. |
Kommentarer
Överlagringarna av den här metoden blockerar inte när autentisering pågår. Om du vill blockera i väntan på att autentiseringen ska slutföras använder du någon av AuthenticateAsClient metoderna.
BeginAuthenticateAsClient(String, AsyncCallback, Object)
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::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 IAsyncResultParametrar
- asyncCallback
- AsyncCallback
Ett AsyncCallback ombud som refererar till metoden för att anropa när autentiseringen är klar.
- asyncState
- Object
Ett användardefinierat objekt som innehåller information om åtgärden. Det här objektet skickas till ombudet asyncCallback när åtgärden är klar.
Returer
Ett IAsyncResult objekt som anger status för den asynkrona åtgärden.
Undantag
targetHost är null.
Autentiseringen misslyckades och lämnade objektet i ett oanvändbart tillstånd.
Autentiseringen har redan inträffat.
-eller-
Serverautentisering med detta SslStream försöktes tidigare.
-eller-
Autentisering pågår redan.
Det här objektet har stängts.
Kommentarer
Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry). Inga klientcertifikat används i autentiseringen. Listan över återkallade certifikat kontrolleras inte under autentiseringen.
Värdet som anges för targetHost måste matcha namnet på serverns certifikat.
Den asynkrona autentiseringsåtgärden måste slutföras genom att anropa EndAuthenticateAsClient metoden. Metoden anropas vanligtvis av ombudet asyncCallback .
Den här metoden blockerar inte när åtgärden är klar. Om du vill blockera tills åtgärden har slutförts använder du en av AuthenticateAsClient metodöverlagringarna.
Detaljerad information om hur du använder den asynkrona programmeringsmodellen finns i Anropa synkrona metoder asynkront
Om du får en AuthenticationExceptionkan detta SslStream inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.
Gäller för
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten med hjälp av de angivna certifikaten och systemets standardsäkerhetsprotokoll.
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);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 IAsyncResultParametrar
- clientCertificates
- X509CertificateCollection
De X509CertificateCollection som innehåller klientcertifikat.
- checkCertificateRevocation
- Boolean
Ett Boolean värde som anger om listan över återkallade certifikat kontrolleras under autentiseringen.
- asyncCallback
- AsyncCallback
Ett AsyncCallback ombud som refererar till metoden för att anropa när autentiseringen är klar.
- asyncState
- Object
Ett användardefinierat objekt som innehåller information om åtgärden. Det här objektet skickas till ombudet asyncCallback när åtgärden är klar.
Returer
Ett IAsyncResult objekt som anger status för den asynkrona åtgärden.
Undantag
targetHost är null.
Autentiseringen misslyckades och lämnade objektet i ett oanvändbart tillstånd.
Autentiseringen har redan inträffat.
-eller-
Serverautentisering med detta SslStream försöktes tidigare.
-eller-
Autentisering pågår redan.
Det här objektet har stängts.
Kommentarer
Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry).
Värdet som anges för targetHost måste matcha namnet på serverns certifikat.
Den asynkrona autentiseringsåtgärden måste slutföras genom att anropa EndAuthenticateAsClient metoden. Metoden anropas vanligtvis av ombudet asyncCallback .
Den här metoden blockerar inte när åtgärden är klar. Om du vill blockera tills åtgärden har slutförts använder du en av AuthenticateAsClient metodöverlagringarna.
Detaljerad information om hur du använder den asynkrona programmeringsmodellen finns i Anropa synkrona metoder asynkront
Om du får en AuthenticationExceptionkan detta SslStream inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.
Note
Klientcertifikat stöds inte i SSL version 2-protokollet.
Gäller för
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
Anropas av klienter för att påbörja en asynkron åtgärd för att autentisera servern och eventuellt klienten med hjälp av de angivna certifikaten och säkerhetsprotokollet.
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);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 IAsyncResultParametrar
- clientCertificates
- X509CertificateCollection
De X509CertificateCollection som innehåller klientcertifikat.
- enabledSslProtocols
- SslProtocols
Värdet SslProtocols som representerar protokoll som används för autentisering.
- checkCertificateRevocation
- Boolean
Ett Boolean värde som anger om listan över återkallade certifikat kontrolleras under autentiseringen.
- asyncCallback
- AsyncCallback
Ett AsyncCallback ombud som refererar till metoden för att anropa när autentiseringen är klar.
- asyncState
- Object
Ett användardefinierat objekt som innehåller information om åtgärden. Det här objektet skickas till ombudet asyncCallback när åtgärden är klar.
Returer
Ett IAsyncResult objekt som anger status för den asynkrona åtgärden.
Undantag
targetHost är null.
enabledSslProtocols är inte ett giltigt SslProtocols värde.
Autentiseringen misslyckades och lämnade objektet i ett oanvändbart tillstånd.
Autentiseringen har redan inträffat.
-eller-
Serverautentisering med detta SslStream försöktes tidigare.
-eller-
Autentisering pågår redan.
Det här objektet har stängts.
Kommentarer
Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry).
Värdet som anges för targetHost måste matcha namnet på serverns certifikat.
Den asynkrona autentiseringsåtgärden måste slutföras genom att anropa EndAuthenticateAsClient metoden. Metoden anropas vanligtvis av ombudet asyncCallback .
Den här metoden blockerar inte när åtgärden är klar. Om du vill blockera tills åtgärden har slutförts använder du en av AuthenticateAsClient metodöverlagringarna.
Detaljerad information om hur du använder den asynkrona programmeringsmodellen finns i Anropa synkrona metoder asynkront
Om du får en AuthenticationExceptionkan detta SslStream inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.
Note
Klientcertifikat stöds inte i SSL version 2-protokollet.