SslStream.BeginAuthenticateAsClient Metoda

Reference

Definice

Obor názvů:: System.Net.Security

Sestavení:: System.Net.Security.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zahájí operaci ověření připojení klient-server na straně klienta.

Přetížení

BeginAuthenticateAsClient(String, AsyncCallback, Object)	Volali klienti k zahájení asynchronní operace pro ověření serveru a volitelně klienta.
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	Volali klienti k zahájení asynchronní operace pro ověření serveru a případně klienta pomocí zadaných certifikátů a výchozího protokolu zabezpečení systému.
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	Volali klienti k zahájení asynchronní operace pro ověření serveru a případně klienta pomocí zadaných certifikátů a protokolu zabezpečení.

Poznámky

Přetížení této metody neblokují, zatímco probíhá ověřování. Pokud chcete blokování blokovat při čekání na dokončení ověřování, použijte některou AuthenticateAsClient z metod .

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Volali klienti k zahájení asynchronní operace pro ověření serveru a volitelně klienta.

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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost: String

Název serveru, který sdílí tento SslStreamserver .

asyncCallback: AsyncCallback

Delegát AsyncCallback , který odkazuje na metodu k vyvolání po dokončení ověřování.

asyncState: Object

Uživatelem definovaný objekt, který obsahuje informace o operaci. Tento objekt se po dokončení operace předá asyncCallback delegátu.

Návraty

IAsyncResult

Objekt IAsyncResult , který označuje stav asynchronní operace.

Výjimky

ArgumentNullException

targetHost je null.

AuthenticationException

Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.

InvalidOperationException

Ověřování již proběhlo.

-nebo-

Ověření serveru pomocí tohoto SslStream ověření bylo vyzkoušeno dříve.

-nebo-

Ověřování již probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

Poznámky

Počínaje rozhraním .NET Framework 4.7 se tato metoda ověřuje pomocí None, což umožňuje operačnímu systému zvolit nejlepší protokol, který se má použít, a blokovat protokoly, které nejsou zabezpečené. V rozhraní .NET Framework 4.6 (a .NET Framework 4.5 s nainstalovanými nejnovějšími opravami zabezpečení) jsou povolené verze protokolů TLS/SSL 1.2, 1.1 a 1.0 (pokud nezakážete silnou kryptografii úpravou registru systému Windows). Při ověřování se nepoužívají žádné klientské certifikáty. Seznam odvolaných certifikátů se během ověřování nekontroluje.

Hodnota zadaná pro targetHost musí odpovídat názvu v certifikátu serveru.

Asynchronní ověřovací operaci musí být dokončena voláním metody .EndAuthenticateAsClient Obvykle je metoda vyvolána delegátem asyncCallback .

Tato metoda neblokuje po dokončení operace. Pokud chcete blokovat, dokud se operace neskončeje, použijte jedno z AuthenticateAsClient přetížení metody.

Podrobné informace o použití asynchronního programovacího modelu najdete v tématu Asynchronní volání synchronních metod.

Pokud obdržíte AuthenticationException, už se SslStream nedá použít. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

Platí pro

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Volali klienti k zahájení asynchronní operace pro ověření serveru a případně klienta pomocí zadaných certifikátů a výchozího protokolu zabezpečení systému.

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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost: String

Název serveru, který sdílí tento SslStreamserver .

clientCertificates: X509CertificateCollection

Obsahující X509CertificateCollection klientské certifikáty.

checkCertificateRevocation: Boolean

Hodnota Boolean , která určuje, jestli je během ověřování kontrolován seznam odvolaných certifikátů.

asyncCallback: AsyncCallback

Delegát AsyncCallback , který odkazuje na metodu k vyvolání po dokončení ověřování.

asyncState: Object

Uživatelem definovaný objekt, který obsahuje informace o operaci. Tento objekt se po dokončení operace předá asyncCallback delegátu.

Návraty

IAsyncResult

Objekt IAsyncResult , který označuje stav asynchronní operace.

Výjimky

ArgumentNullException

targetHost je null.

AuthenticationException

Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.

InvalidOperationException

Ověřování již proběhlo.

-nebo-

Ověření serveru pomocí tohoto SslStream ověření bylo vyzkoušeno dříve.

-nebo-

Ověřování již probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

Poznámky

Hodnota zadaná pro targetHost musí odpovídat názvu v certifikátu serveru.

Asynchronní ověřovací operaci musí být dokončena voláním metody .EndAuthenticateAsClient Obvykle je metoda vyvolána delegátem asyncCallback .

Tato metoda neblokuje po dokončení operace. Pokud chcete blokovat, dokud se operace neskončeje, použijte jedno z AuthenticateAsClient přetížení metody.

Podrobné informace o použití asynchronního programovacího modelu najdete v tématu Asynchronní volání synchronních metod.

Pokud obdržíte AuthenticationException, už se SslStream nedá použít. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

Poznámka

Protokol SSL verze 2 nepodporuje klientské certifikáty.

Platí pro

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Zdroj:: SslStream.cs

Volali klienti k zahájení asynchronní operace pro ověření serveru a případně klienta pomocí zadaných certifikátů a protokolu zabezpečení.

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 -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost: String

Název serveru, který sdílí tento SslStreamserver .

clientCertificates: X509CertificateCollection

Obsahující X509CertificateCollection klientské certifikáty.

enabledSslProtocols: SslProtocols

Hodnota SslProtocols , která představuje protokoly používané k ověřování.

checkCertificateRevocation: Boolean

Hodnota Boolean , která určuje, jestli je během ověřování kontrolován seznam odvolaných certifikátů.

asyncCallback: AsyncCallback

Delegát AsyncCallback , který odkazuje na metodu k vyvolání po dokončení ověřování.

asyncState: Object

Uživatelem definovaný objekt, který obsahuje informace o operaci. Tento objekt se po dokončení operace předá asyncCallback delegátu.

Návraty

IAsyncResult

Objekt IAsyncResult , který označuje stav asynchronní operace.

Výjimky

ArgumentNullException

targetHost je null.

ArgumentException

enabledSslProtocols není platná SslProtocols hodnota.

AuthenticationException

Ověřování se nezdařilo a tento objekt zůstal v nepoužitelném stavu.

InvalidOperationException

Ověřování již proběhlo.

-nebo-

Ověření serveru pomocí tohoto SslStream ověření bylo vyzkoušeno dříve.

-nebo-

Ověřování již probíhá.

ObjectDisposedException

Tento objekt byl uzavřen.

Poznámky

Hodnota zadaná pro targetHost musí odpovídat názvu v certifikátu serveru.

Asynchronní ověřovací operaci musí být dokončena voláním metody .EndAuthenticateAsClient Obvykle je metoda vyvolána delegátem asyncCallback .

Tato metoda neblokuje po dokončení operace. Pokud chcete blokovat, dokud se operace neskončeje, použijte jedno z AuthenticateAsClient přetížení metody.

Podrobné informace o použití asynchronního programovacího modelu najdete v tématu Asynchronní volání synchronních metod.

Pokud obdržíte AuthenticationException, už se SslStream nedá použít. Tento objekt byste měli zavřít a odebrat všechny odkazy na něj, aby ho mohl systém uvolňování paměti shromáždit.

Poznámka

Protokol SSL verze 2 nepodporuje klientské certifikáty.

Platí pro

Sdílet prostřednictvím

SslStream.BeginAuthenticateAsClient Metoda

Definice

Přetížení

Poznámky

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály