SslStream.BeginAuthenticateAsClient Metode

Referensi

Definisi

Ruang nama:: System.Net.Security

Rakitan:: System.Net.Security.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Memulai operasi untuk mengautentikasi sisi klien koneksi server klien.

Overload

BeginAuthenticateAsClient(String, AsyncCallback, Object)	Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien.
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat yang ditentukan dan protokol keamanan default sistem.
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat dan protokol keamanan yang ditentukan.

Keterangan

Kelebihan beban metode ini tidak memblokir saat autentikasi sedang berlangsung. Untuk memblokir sambil menunggu autentikasi selesai, gunakan salah AuthenticateAsClient satu metode .

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien.

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

Parameter

targetHost: String

Nama server yang berbagi ini SslStream.

asyncCallback: AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.

asyncState: Object

Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.

Mengembalikan

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

Pengecualian

ArgumentNullException

targetHostadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Dimulai dengan .NET Framework 4.7, metode ini mengautentikasi menggunakan None, yang memungkinkan sistem operasi untuk memilih protokol terbaik untuk digunakan, dan untuk memblokir protokol yang tidak aman. Dalam .NET Framework 4.6 (dan .NET Framework 4.5 dengan patch keamanan terbaru yang diinstal), versi protokol TLS/SSL yang diizinkan adalah 1.2, 1.1, dan 1.0 (kecuali Anda menonaktifkan kriptografi yang kuat dengan mengedit Windows Registry). Tidak ada sertifikat klien yang digunakan dalam autentikasi. Daftar pencabutan sertifikat tidak diperiksa selama autentikasi.

Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.

Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.

Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.

Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron

Jika Anda menerima AuthenticationException, ini SslStream tidak lagi dapat digunakan. Anda harus menutup objek ini dan menghapus semua referensi ke objek tersebut sehingga dapat dikumpulkan oleh pengumpul sampah.

Berlaku untuk

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

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat yang ditentukan dan protokol keamanan default sistem.

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

Parameter

targetHost: String

Nama server yang berbagi ini SslStream.

clientCertificates: X509CertificateCollection

Yang X509CertificateCollection berisi sertifikat klien.

checkCertificateRevocation: Boolean

Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.

asyncCallback: AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.

asyncState: Object

Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.

Mengembalikan

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

Pengecualian

ArgumentNullException

targetHostadalah null.

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.

Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.

Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.

Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron

Catatan

Sertifikat klien tidak didukung dalam protokol SSL versi 2.

Berlaku untuk

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

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Sumber:: SslStream.cs

Dipanggil oleh klien untuk memulai operasi asinkron untuk mengautentikasi server dan secara opsional klien menggunakan sertifikat dan protokol keamanan yang ditentukan.

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

Parameter

targetHost: String

Nama server yang berbagi ini SslStream.

clientCertificates: X509CertificateCollection

Yang X509CertificateCollection berisi sertifikat klien.

enabledSslProtocols: SslProtocols

Nilai SslProtocols yang mewakili protokol yang digunakan untuk autentikasi.

checkCertificateRevocation: Boolean

Boolean Nilai yang menentukan apakah daftar pencabutan sertifikat diperiksa selama autentikasi.

asyncCallback: AsyncCallback

Delegasi AsyncCallback yang mereferensikan metode yang akan dipanggil saat autentikasi selesai.

asyncState: Object

Objek yang ditentukan pengguna yang berisi informasi tentang operasi. Objek ini diteruskan ke asyncCallback delegasi ketika operasi selesai.

Mengembalikan

IAsyncResult

Objek IAsyncResult yang menunjukkan status operasi asinkron.

Pengecualian

ArgumentNullException

targetHostadalah null.

ArgumentException

enabledSslProtocols bukan nilai yang valid SslProtocols .

AuthenticationException

Autentikasi gagal dan membiarkan objek ini dalam keadaan tidak dapat digunakan.

InvalidOperationException

Autentikasi telah terjadi.

-atau-

Autentikasi server menggunakan ini SslStream telah dicoba sebelumnya.

-atau-

Autentikasi sedang berlangsung.

ObjectDisposedException

Objek ini telah ditutup.

Keterangan

Nilai yang ditentukan untuk targetHost harus cocok dengan nama pada sertifikat server.

Operasi autentikasi asinkron harus diselesaikan dengan memanggil EndAuthenticateAsClient metode . Biasanya, metode ini dipanggil oleh asyncCallback delegasi.

Metode ini tidak memblokir saat operasi selesai. Untuk memblokir hingga operasi selesai, gunakan salah satu metode kelebihan AuthenticateAsClient beban.

Untuk informasi terperinci tentang menggunakan model pemrograman asinkron, lihat Memanggil Metode Sinkron Secara Asinkron

Catatan

Sertifikat klien tidak didukung dalam protokol SSL versi 2.

Berlaku untuk

Bagikan melalui

SslStream.BeginAuthenticateAsClient Metode

Definisi

Overload

Keterangan

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: