SslStream.BeginAuthenticateAsClient Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een bewerking gestart om de clientzijde van een client-serververbinding te verifiëren.
Overloads
| Name | Description |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Aangeroepen door clients om een asynchrone bewerking te starten om de server en eventueel de client te verifiëren. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Clients worden aangeroepen om een asynchrone bewerking te starten om de server te verifiëren en eventueel de client met behulp van de opgegeven certificaten en het standaardbeveiligingsprotocol van het systeem. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Clients worden aangeroepen om een asynchrone bewerking te starten om de server te verifiëren en eventueel de client met behulp van de opgegeven certificaten en het beveiligingsprotocol. |
Opmerkingen
De overbelasting van deze methode wordt niet geblokkeerd terwijl de verificatie wordt uitgevoerd. Als u wilt blokkeren totdat de verificatie is voltooid, gebruikt u een van de AuthenticateAsClient methoden.
BeginAuthenticateAsClient(String, AsyncCallback, Object)
Aangeroepen door clients om een asynchrone bewerking te starten om de server en eventueel de client te verifiëren.
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 IAsyncResultParameters
- asyncCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de verificatie is voltooid.
- asyncState
- Object
Een door de gebruiker gedefinieerd object dat informatie over de bewerking bevat. Dit object wordt doorgegeven aan de asyncCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat de status van de asynchrone bewerking aangeeft.
Uitzonderingen
targetHost is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken). Er worden geen clientcertificaten gebruikt in de verificatie. De certificaatintrekkingslijst wordt niet gecontroleerd tijdens verificatie.
De opgegeven targetHost waarde moet overeenkomen met de naam op het certificaat van de server.
De asynchrone verificatiebewerking moet worden voltooid door de methode aan te EndAuthenticateAsClient roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode blokkeert niet terwijl de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de AuthenticateAsClient methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel
Als u een AuthenticationExceptionontvangt, is dit SslStream niet meer bruikbaar. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
Van toepassing op
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
Clients worden aangeroepen om een asynchrone bewerking te starten om de server te verifiëren en eventueel de client met behulp van de opgegeven certificaten en het standaardbeveiligingsprotocol van het systeem.
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 IAsyncResultParameters
- clientCertificates
- X509CertificateCollection
Het X509CertificateCollection met clientcertificaten.
- checkCertificateRevocation
- Boolean
Een Boolean waarde die aangeeft of de certificaatintrekkingslijst tijdens de verificatie wordt gecontroleerd.
- asyncCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de verificatie is voltooid.
- asyncState
- Object
Een door de gebruiker gedefinieerd object dat informatie over de bewerking bevat. Dit object wordt doorgegeven aan de asyncCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat de status van de asynchrone bewerking aangeeft.
Uitzonderingen
targetHost is null.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken).
De opgegeven targetHost waarde moet overeenkomen met de naam op het certificaat van de server.
De asynchrone verificatiebewerking moet worden voltooid door de methode aan te EndAuthenticateAsClient roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode blokkeert niet terwijl de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de AuthenticateAsClient methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel
Als u een AuthenticationExceptionontvangt, is dit SslStream niet meer bruikbaar. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
Note
Clientcertificaten worden niet ondersteund in het SSL-protocol versie 2.
Van toepassing op
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
Clients worden aangeroepen om een asynchrone bewerking te starten om de server te verifiëren en eventueel de client met behulp van de opgegeven certificaten en het beveiligingsprotocol.
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 IAsyncResultParameters
- clientCertificates
- X509CertificateCollection
Het X509CertificateCollection met clientcertificaten.
- enabledSslProtocols
- SslProtocols
De SslProtocols waarde die protocollen vertegenwoordigt die worden gebruikt voor verificatie.
- checkCertificateRevocation
- Boolean
Een Boolean waarde die aangeeft of de certificaatintrekkingslijst tijdens de verificatie wordt gecontroleerd.
- asyncCallback
- AsyncCallback
Een AsyncCallback gemachtigde die verwijst naar de methode die moet worden aangeroepen wanneer de verificatie is voltooid.
- asyncState
- Object
Een door de gebruiker gedefinieerd object dat informatie over de bewerking bevat. Dit object wordt doorgegeven aan de asyncCallback gemachtigde wanneer de bewerking is voltooid.
Retouren
Een IAsyncResult object dat de status van de asynchrone bewerking aangeeft.
Uitzonderingen
targetHost is null.
enabledSslProtocols is geen geldige SslProtocols waarde.
De verificatie is mislukt en heeft dit object een onbruikbare status.
Verificatie is al opgetreden.
– of –
Serververificatie waarbij dit SslStream wordt gebruikt, is eerder geprobeerd.
– of –
Verificatie wordt al uitgevoerd.
Dit object is gesloten.
Opmerkingen
Vanaf .NET Framework 4.7 verifieert deze methode met behulp van None, waarmee het besturingssysteem het beste protocol kan kiezen en protocollen blokkeert die niet beveiligd zijn. In .NET Framework 4.6 (en .NET Framework 4.5 waarop de nieuwste beveiligingspatches zijn geïnstalleerd), zijn de toegestane versies van TLS/SSL-protocollen 1.2, 1.1 en 1.0 (tenzij u sterke cryptografie uitschakelt door het Windows Register te bewerken).
De opgegeven targetHost waarde moet overeenkomen met de naam op het certificaat van de server.
De asynchrone verificatiebewerking moet worden voltooid door de methode aan te EndAuthenticateAsClient roepen. Normaal gesproken wordt de methode aangeroepen door de asyncCallback gemachtigde.
Deze methode blokkeert niet terwijl de bewerking is voltooid. Als u wilt blokkeren totdat de bewerking is voltooid, gebruikt u een van de overbelastingen van de AuthenticateAsClient methode.
Zie Synchrone methoden asynchroon aanroepen voor gedetailleerde informatie over het gebruik van het asynchrone programmeermodel
Als u een AuthenticationExceptionontvangt, is dit SslStream niet meer bruikbaar. Sluit dit object en verwijder alle verwijzingen naar het object, zodat het kan worden verzameld door de garbagecollector.
Note
Clientcertificaten worden niet ondersteund in het SSL-protocol versie 2.