1 <?xml version="1.0" encoding="utf-8"?><span>
4 <name>System.Net.Security</name>
7 <member name="T:System.Net.Security.AuthenticatedStream">
8 <summary>Provides methods for passing credentials across a stream and requesting or performing authentication for client-server applications.</summary>
10 <member name="M:System.Net.Security.AuthenticatedStream.#ctor(System.IO.Stream,System.Boolean)">
11 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.AuthenticatedStream"></see> class.</summary>
12 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.AuthenticatedStream"></see> for sending and receiving data.</param>
13 <param name="leaveInnerStreamOpen">A <see cref="T:System.Boolean"></see> that indicates whether closing this <see cref="T:System.Net.Security.AuthenticatedStream"></see> object also closes innerStream.</param>
14 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
16 <member name="M:System.Net.Security.AuthenticatedStream.Dispose(System.Boolean)">
17 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.Security.AuthenticatedStream"></see> and optionally releases the managed resources.</summary>
18 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
20 <member name="P:System.Net.Security.AuthenticatedStream.InnerStream">
21 <summary>Gets the stream used by this <see cref="T:System.Net.Security.AuthenticatedStream"></see> for sending and receiving data.</summary>
22 <returns>A <see cref="T:System.IO.Stream"></see> object.</returns>
24 <member name="P:System.Net.Security.AuthenticatedStream.IsAuthenticated">
25 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether authentication was successful.</summary>
26 <returns>true if successful authentication occurred; otherwise, false.</returns>
28 <member name="P:System.Net.Security.AuthenticatedStream.IsEncrypted">
29 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether data sent using this <see cref="T:System.Net.Security.AuthenticatedStream"></see> is encrypted.</summary>
30 <returns>true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise, false.</returns>
32 <member name="P:System.Net.Security.AuthenticatedStream.IsMutuallyAuthenticated">
33 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether both server and client have been authenticated.</summary>
34 <returns>true if the client and server have been authenticated; otherwise, false.</returns>
36 <member name="P:System.Net.Security.AuthenticatedStream.IsServer">
37 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the local side of the connection was authenticated as the server.</summary>
38 <returns>true if the local endpoint was authenticated as the server side of a client-server authenticated connection; false if the local endpoint was authenticated as the client.</returns>
40 <member name="P:System.Net.Security.AuthenticatedStream.IsSigned">
41 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the data sent using this stream is signed.</summary>
42 <returns>true if the data is signed before being transmitted; otherwise, false.</returns>
44 <member name="P:System.Net.Security.AuthenticatedStream.LeaveInnerStreamOpen">
45 <summary>Gets whether the stream used by this <see cref="T:System.Net.Security.AuthenticatedStream"></see> for sending and receiving data has been left open.</summary>
46 <returns>true if the inner stream has been left open; otherwise, false.</returns>
48 <member name="T:System.Net.Security.EncryptionPolicy">
49 <summary>The EncryptionPolicy to use.</summary>
51 <member name="F:System.Net.Security.EncryptionPolicy.AllowNoEncryption">
52 <summary>Prefer that full encryption be used, but allow a NULL cipher (no encryption) if the server agrees.</summary>
55 <member name="F:System.Net.Security.EncryptionPolicy.NoEncryption">
56 <summary>Allow no encryption and request that a NULL cipher be used if the other endpoint can handle a NULL cipher.</summary>
59 <member name="F:System.Net.Security.EncryptionPolicy.RequireEncryption">
60 <summary>Require encryption and never allow a NULL cipher.</summary>
63 <member name="T:System.Net.Security.LocalCertificateSelectionCallback">
64 <summary>Selects the local Secure Sockets Layer (SSL) certificate used for authentication.</summary>
65 <param name="sender">An object that contains state information for this validation.</param>
66 <param name="targetHost">The host server specified by the client.</param>
67 <param name="localCertificates">An <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> containing local certificates.</param>
68 <param name="remoteCertificate">The certificate used to authenticate the remote party.</param>
69 <param name="acceptableIssuers">A <see cref="T:System.String"></see> array of certificate issuers acceptable to the remote party.</param>
72 <member name="T:System.Net.Security.NegotiateStream">
73 <summary>Provides a stream that uses the Negotiate security protocol to authenticate the client, and optionally the server, in client-server communication.</summary>
75 <member name="M:System.Net.Security.NegotiateStream.#ctor(System.IO.Stream)">
76 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.NegotiateStream"></see> class using the specified <see cref="T:System.IO.Stream"></see>.</summary>
77 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.NegotiateStream"></see> for sending and receiving data.</param>
79 <member name="M:System.Net.Security.NegotiateStream.#ctor(System.IO.Stream,System.Boolean)">
80 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.NegotiateStream"></see> class using the specified <see cref="T:System.IO.Stream"></see> and stream closure behavior.</summary>
81 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.NegotiateStream"></see> for sending and receiving data.</param>
82 <param name="leaveInnerStreamOpen">true to indicate that closing this <see cref="T:System.Net.Security.NegotiateStream"></see> has no effect on innerstream; false to indicate that closing this <see cref="T:System.Net.Security.NegotiateStream"></see> also closes innerStream.</param>
83 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. - or - <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
85 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClient">
86 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection.</summary>
87 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
88 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
89 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
90 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
92 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClient(System.Net.NetworkCredential,System.String)">
93 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified client credential.</summary>
94 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
95 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
96 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
97 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
98 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
99 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
100 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null.</exception>
102 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClient(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String)">
103 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified client credential and the channel binding.</summary>
104 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
105 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
106 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
107 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null. - or - <paramref name="credential">credential</paramref> is null.</exception>
108 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
109 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
110 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
111 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
113 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClient(System.Net.NetworkCredential,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
114 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and authentication options.</summary>
115 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
116 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
117 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
118 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
119 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="allowedImpersonationLevel">allowedImpersonationLevel</paramref> is not a valid value.</exception>
120 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null.</exception>
121 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
122 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
123 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
124 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
126 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClient(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
127 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credential, authentication options, and channel binding.</summary>
128 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
129 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
130 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
131 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
132 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
133 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null. - or - <paramref name="credential">credential</paramref> is null.</exception>
134 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="allowedImpersonationLevel">allowedImpersonationLevel</paramref> is not a valid value.</exception>
135 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
136 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
137 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
138 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
140 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClientAsync">
141 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation.</summary>
142 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
143 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
144 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
145 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
146 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
148 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClientAsync(System.Net.NetworkCredential,System.String)">
149 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified client credential.</summary>
150 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
151 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
152 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
153 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
154 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
155 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
156 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
157 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null.</exception>
159 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClientAsync(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String)">
160 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified client credential and the channel binding.</summary>
161 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
162 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
163 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
164 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
165 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null. - or - <paramref name="credential">credential</paramref> is null.</exception>
166 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
167 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
168 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
169 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
171 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClientAsync(System.Net.NetworkCredential,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
172 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified credentials and authentication options.</summary>
173 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
174 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
175 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
176 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
177 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
178 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="allowedImpersonationLevel">allowedImpersonationLevel</paramref> is not a valid value.</exception>
179 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null.</exception>
180 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
181 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
182 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
183 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
185 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsClientAsync(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
186 <summary>Called by clients to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified credential, authentication options, and channel binding.</summary>
187 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
188 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
189 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
190 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
191 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
192 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
193 <exception cref="T:System.ArgumentNullException"><paramref name="targetName">targetName</paramref> is null. - or - <paramref name="credential">credential</paramref> is null.</exception>
194 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="allowedImpersonationLevel">allowedImpersonationLevel</paramref> is not a valid value.</exception>
195 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
196 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
197 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
198 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
200 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServer(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
201 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials, authentication options, and extended protection policy.</summary>
202 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
203 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
204 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
205 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
206 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
207 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
208 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
209 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to try to r-authenticate.</exception>
210 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
211 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
212 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
213 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
214 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
216 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServer(System.Net.NetworkCredential,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
217 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials and authentication options.</summary>
218 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the server.</param>
219 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
220 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
221 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
222 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
223 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to try to r-authenticate.</exception>
224 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
225 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
226 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
227 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
229 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServer">
230 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection.</summary>
231 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
232 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
233 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
234 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
236 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServer(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy)">
237 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified extended protection policy.</summary>
238 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
239 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
240 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
241 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
242 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
243 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
244 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
246 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServerAsync">
247 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation.</summary>
248 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
249 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
250 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
251 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
252 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
254 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServerAsync(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy)">
255 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified extended protection policy.</summary>
256 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
257 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
258 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
259 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
260 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
261 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
262 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
263 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
265 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServerAsync(System.Net.NetworkCredential,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
266 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified server credentials and authentication options.</summary>
267 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the server.</param>
268 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
269 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
270 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
271 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
272 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
273 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to try to r-authenticate.</exception>
274 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
275 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
276 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
277 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
279 <member name="M:System.Net.Security.NegotiateStream.AuthenticateAsServerAsync(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel)">
280 <summary>Called by servers to authenticate the client, and optionally the server, in a client-server connection as an asynchronous operation. The authentication process uses the specified server credentials, authentication options, and extended protection policy.</summary>
281 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
282 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
283 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
284 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
285 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
286 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
287 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
288 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
289 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to try to r-authenticate.</exception>
290 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
291 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
292 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
293 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
294 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
296 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel,System.AsyncCallback,System.Object)">
297 <summary>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials, authentication options, and channel binding. This method does not block.</summary>
298 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
299 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
300 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
301 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
302 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
303 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
304 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
305 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
306 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null. - or - <paramref name="targetName">targetName</paramref> is null.</exception>
307 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
308 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
309 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
310 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
312 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient(System.AsyncCallback,System.Object)">
313 <summary>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block.</summary>
314 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
315 <param name="asyncState">A user-defined object containing information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
316 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
317 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
318 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
319 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
320 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
322 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient(System.Net.NetworkCredential,System.String,System.AsyncCallback,System.Object)">
323 <summary>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials. This method does not block.</summary>
324 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
325 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
326 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
327 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
328 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
329 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null. - or - <paramref name="targetName">targetName</paramref> is null.</exception>
330 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
331 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
332 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
333 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
335 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ChannelBinding,System.String,System.AsyncCallback,System.Object)">
336 <summary>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and channel binding. This method does not block.</summary>
337 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
338 <param name="binding">The <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that is used for extended protection.</param>
339 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
340 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
341 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
342 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
343 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null. - or - <paramref name="targetName">targetName</paramref> is null.</exception>
344 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
345 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
346 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
347 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
349 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient(System.Net.NetworkCredential,System.String,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel,System.AsyncCallback,System.Object)">
350 <summary>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and authentication options. This method does not block.</summary>
351 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
352 <param name="targetName">The Service Principal Name (SPN) that uniquely identifies the server to authenticate.</param>
353 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
354 <param name="allowedImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
355 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
356 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
357 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
358 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null. - or - <paramref name="targetName">targetName</paramref> is null.</exception>
359 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
360 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
361 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
362 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the server. You cannot use the stream to retry authentication as the client.</exception>
364 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer(System.Net.NetworkCredential,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel,System.AsyncCallback,System.Object)">
365 <summary>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials and authentication options. This method does not block.</summary>
366 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
367 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
368 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
369 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
370 <param name="asyncState">A user-defined object containing information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
371 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
372 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
373 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
374 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
375 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
376 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
377 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
378 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
380 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer(System.Net.NetworkCredential,System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy,System.Net.Security.ProtectionLevel,System.Security.Principal.TokenImpersonationLevel,System.AsyncCallback,System.Object)">
381 <summary>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials, authentication options, and extended protection policy. This method does not block.</summary>
382 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that is used to establish the identity of the client.</param>
383 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
384 <param name="requiredProtectionLevel">One of the <see cref="T:System.Net.Security.ProtectionLevel"></see> values, indicating the security services for the stream.</param>
385 <param name="requiredImpersonationLevel">One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values, indicating how the server can use the client's credentials to access resources.</param>
386 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
387 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
388 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
389 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
390 <exception cref="T:System.ArgumentNullException"><paramref name="credential">credential</paramref> is null.</exception>
391 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="requiredImpersonationLevel">requiredImpersonationLevel</paramref> must be <see cref="F:System.Security.Principal.TokenImpersonationLevel.Identification"></see>, <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation"></see>, or <see cref="F:System.Security.Principal.TokenImpersonationLevel.Delegation"></see>,</exception>
392 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
393 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
394 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. - or - This stream was used previously to attempt authentication as the client. You cannot use the stream to retry authentication as the server.</exception>
395 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
396 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
397 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
399 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer(System.AsyncCallback,System.Object)">
400 <summary>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block.</summary>
401 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
402 <param name="asyncState">A user-defined object containing information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
403 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
404 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
405 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
406 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
407 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
409 <member name="M:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer(System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy,System.AsyncCallback,System.Object)">
410 <summary>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified extended protection policy. This method does not block.</summary>
411 <param name="policy">The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that is used for extended protection.</param>
412 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
413 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
414 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
415 <exception cref="T:System.ArgumentException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> and <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames"></see> on the extended protection policy passed in the <paramref name="policy">policy</paramref> parameter are both null.</exception>
416 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
417 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
418 <exception cref="T:System.NotSupportedException">Windows 95 and Windows 98 are not supported.</exception>
419 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
420 <exception cref="T:System.PlatformNotSupportedException">The <paramref name="policy">policy</paramref> parameter was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
422 <member name="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)">
423 <summary>Begins an asynchronous read operation that reads data from the stream and stores it in the specified array.</summary>
424 <param name="buffer">A <see cref="T:System.Byte"></see> array that receives the bytes read from the stream.</param>
425 <param name="offset">The zero-based location in buffer at which to begin storing the data read from this stream.</param>
426 <param name="count">The maximum number of bytes to read from the stream.</param>
427 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the read operation is complete.</param>
428 <param name="asyncState">A user-defined object containing information about the read operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
429 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
430 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
431 <exception cref="T:System.ArgumentException"><paramref name="offset">offset</paramref> is less than 0. - or - <paramref name="offset">offset</paramref> is greater than the length of <paramref name="buffer">buffer</paramref>. - or - <paramref name="offset">offset</paramref> plus <paramref name="count">count</paramref> is greater than the length of <paramref name="buffer">buffer</paramref>.</exception>
432 <exception cref="T:System.IO.IOException">The read operation failed. - or - Encryption is in use, but the data could not be decrypted.</exception>
433 <exception cref="T:System.NotSupportedException">There is already a read operation in progress.</exception>
434 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
435 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
437 <member name="M:System.Net.Security.NegotiateStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)">
438 <summary>Begins an asynchronous write operation that writes <see cref="T:System.Byte"></see>s from the specified buffer to the stream.</summary>
439 <param name="buffer">A <see cref="T:System.Byte"></see> array that supplies the bytes to be written to the stream.</param>
440 <param name="offset">The zero-based location in buffer at which to begin reading bytes to be written to the stream.</param>
441 <param name="count">An <see cref="T:System.Int32"></see> value that specifies the number of bytes to read from buffer.</param>
442 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the write operation is complete.</param>
443 <param name="asyncState">A user-defined object containing information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
444 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
445 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
446 <exception cref="T:System.ArgumentException"><paramref name="offset is less than 0">offset is less than 0</paramref>. - or - <paramref name="offset">offset</paramref> is greater than the length of <paramref name="buffer">buffer</paramref>. - or - <paramref name="offset">offset</paramref> plus count is greater than the length of <paramref name="buffer">buffer</paramref>.</exception>
447 <exception cref="T:System.IO.IOException">The write operation failed. - or - Encryption is in use, but the data could not be encrypted.</exception>
448 <exception cref="T:System.NotSupportedException">There is already a write operation in progress.</exception>
449 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
450 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
452 <member name="P:System.Net.Security.NegotiateStream.CanRead">
453 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is readable.</summary>
454 <returns>true if authentication has occurred and the underlying stream is readable; otherwise, false.</returns>
456 <member name="P:System.Net.Security.NegotiateStream.CanSeek">
457 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is seekable.</summary>
458 <returns>This property always returns false.</returns>
460 <member name="P:System.Net.Security.NegotiateStream.CanTimeout">
461 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream supports time-outs.</summary>
462 <returns>true if the underlying stream supports time-outs; otherwise, false.</returns>
464 <member name="P:System.Net.Security.NegotiateStream.CanWrite">
465 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is writable.</summary>
466 <returns>true if authentication has occurred and the underlying stream is writable; otherwise, false.</returns>
468 <member name="M:System.Net.Security.NegotiateStream.Dispose(System.Boolean)">
469 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.Security.NegotiateStream"></see> and optionally releases the managed resources.</summary>
470 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
472 <member name="M:System.Net.Security.NegotiateStream.EndAuthenticateAsClient(System.IAsyncResult)">
473 <summary>Ends a pending asynchronous client authentication operation that was started with a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient"></see>.</summary>
474 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient"></see>.</param>
475 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
476 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient"></see>.</exception>
477 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
478 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
479 <exception cref="T:System.InvalidOperationException">There is no pending client authentication to complete.</exception>
481 <member name="M:System.Net.Security.NegotiateStream.EndAuthenticateAsServer(System.IAsyncResult)">
482 <summary>Ends a pending asynchronous client authentication operation that was started with a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer"></see>.</summary>
483 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer"></see>.</param>
484 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
485 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="Overload:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer"></see>.</exception>
486 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed. You can use this object to retry the authentication.</exception>
487 <exception cref="T:System.Security.Authentication.InvalidCredentialException">The authentication failed. You can use this object to retry the authentication.</exception>
488 <exception cref="T:System.InvalidOperationException">There is no pending authentication to complete.</exception>
490 <member name="M:System.Net.Security.NegotiateStream.EndRead(System.IAsyncResult)">
491 <summary>Ends an asynchronous read operation that was started with a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</summary>
492 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see></param>
493 <returns>A <see cref="T:System.Int32"></see> value that specifies the number of bytes read from the underlying stream.</returns>
494 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
495 <exception cref="T:System.ArgumentException">The asyncResult was not created by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</exception>
496 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
497 <exception cref="T:System.IO.IOException">The read operation failed.</exception>
499 <member name="M:System.Net.Security.NegotiateStream.EndWrite(System.IAsyncResult)">
500 <summary>Ends an asynchronous write operation that was started with a call to <see cref="M:System.Net.Security.NegotiateStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</summary>
501 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see></param>
502 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
503 <exception cref="T:System.ArgumentException">The asyncResult was not created by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</exception>
504 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
505 <exception cref="T:System.IO.IOException">The write operation failed.</exception>
507 <member name="M:System.Net.Security.NegotiateStream.Flush">
508 <summary>Causes any buffered data to be written to the underlying device.</summary>
510 <member name="M:System.Net.Security.NegotiateStream.FlushAsync(System.Threading.CancellationToken)">
511 <param name="cancellationToken"></param>
514 <member name="P:System.Net.Security.NegotiateStream.ImpersonationLevel">
515 <summary>Gets a value that indicates how the server can use the client's credentials.</summary>
516 <returns>One of the <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> values.</returns>
517 <exception cref="T:System.InvalidOperationException">Authentication failed or has not occurred.</exception>
519 <member name="P:System.Net.Security.NegotiateStream.IsAuthenticated">
520 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether authentication was successful.</summary>
521 <returns>true if successful authentication occurred; otherwise, false.</returns>
523 <member name="P:System.Net.Security.NegotiateStream.IsEncrypted">
524 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether this <see cref="T:System.Net.Security.NegotiateStream"></see> uses data encryption.</summary>
525 <returns>true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise, false.</returns>
527 <member name="P:System.Net.Security.NegotiateStream.IsMutuallyAuthenticated">
528 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether both the server and the client have been authenticated.</summary>
529 <returns>true if the server has been authenticated; otherwise, false.</returns>
531 <member name="P:System.Net.Security.NegotiateStream.IsServer">
532 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the local side of the connection used by this <see cref="T:System.Net.Security.NegotiateStream"></see> was authenticated as the server.</summary>
533 <returns>true if the local endpoint was successfully authenticated as the server side of the authenticated connection; otherwise, false.</returns>
535 <member name="P:System.Net.Security.NegotiateStream.IsSigned">
536 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the data sent using this stream is signed.</summary>
537 <returns>true if the data is signed before being transmitted; otherwise, false.</returns>
539 <member name="P:System.Net.Security.NegotiateStream.Length">
540 <summary>Gets the length of the underlying stream.</summary>
541 <returns>A <see cref="T:System.Int64"></see> that specifies the length of the underlying stream.</returns>
542 <exception cref="T:System.NotSupportedException">Getting the value of this property is not supported when the underlying stream is a <see cref="T:System.Net.Sockets.NetworkStream"></see>.</exception>
544 <member name="P:System.Net.Security.NegotiateStream.Position">
545 <summary>Gets or sets the current position in the underlying stream.</summary>
546 <returns>A <see cref="T:System.Int64"></see> that specifies the current position in the underlying stream.</returns>
547 <exception cref="T:System.NotSupportedException">Setting this property is not supported. - or - Getting the value of this property is not supported when the underlying stream is a <see cref="T:System.Net.Sockets.NetworkStream"></see>.</exception>
549 <member name="M:System.Net.Security.NegotiateStream.Read(System.Byte[],System.Int32,System.Int32)">
550 <summary>Reads data from this stream and stores it in the specified array.</summary>
551 <param name="buffer">A <see cref="T:System.Byte"></see> array that receives the bytes read from the stream.</param>
552 <param name="offset">A <see cref="T:System.Int32"></see> containing the zero-based location in buffer at which to begin storing the data read from this stream.</param>
553 <param name="count">A <see cref="T:System.Int32"></see> containing the maximum number of bytes to read from the stream.</param>
554 <returns>A <see cref="T:System.Int32"></see> value that specifies the number of bytes read from the underlying stream. When there is no more data to be read, returns 0.</returns>
555 <exception cref="T:System.IO.IOException">The read operation failed.</exception>
556 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
557 <exception cref="T:System.NotSupportedException">A <see cref="M:System.Net.Security.NegotiateStream.Read(System.Byte[],System.Int32,System.Int32)"></see> operation is already in progress.</exception>
559 <member name="P:System.Net.Security.NegotiateStream.ReadTimeout">
560 <summary>Gets or sets the amount of time a read operation blocks waiting for data.</summary>
561 <returns>A <see cref="T:System.Int32"></see> that specifies the amount of time that will elapse before a read operation fails.</returns>
563 <member name="P:System.Net.Security.NegotiateStream.RemoteIdentity">
564 <summary>Gets information about the identity of the remote party sharing this authenticated stream.</summary>
565 <returns>An <see cref="T:System.Security.Principal.IIdentity"></see> object that describes the identity of the remote endpoint.</returns>
566 <exception cref="T:System.InvalidOperationException">Authentication failed or has not occurred.</exception>
568 <member name="M:System.Net.Security.NegotiateStream.Seek(System.Int64,System.IO.SeekOrigin)">
569 <summary>Throws <see cref="T:System.NotSupportedException"></see>.</summary>
570 <param name="offset">This value is ignored.</param>
571 <param name="origin">This value is ignored.</param>
572 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
573 <exception cref="T:System.NotSupportedException">Seeking is not supported on <see cref="T:System.Net.Security.NegotiateStream"></see>.</exception>
575 <member name="M:System.Net.Security.NegotiateStream.SetLength(System.Int64)">
576 <summary>Sets the length of the underlying stream.</summary>
577 <param name="value">An <see cref="T:System.Int64"></see> value that specifies the length of the stream.</param>
579 <member name="M:System.Net.Security.NegotiateStream.Write(System.Byte[],System.Int32,System.Int32)">
580 <summary>Write the specified number of <see cref="T:System.Byte"></see>s to the underlying stream using the specified buffer and offset.</summary>
581 <param name="buffer">A <see cref="T:System.Byte"></see> array that supplies the bytes written to the stream.</param>
582 <param name="offset">An <see cref="T:System.Int32"></see> containing the zero-based location in buffer at which to begin reading bytes to be written to the stream.</param>
583 <param name="count">A <see cref="T:System.Int32"></see> containing the number of bytes to read from buffer.</param>
584 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
585 <exception cref="T:System.ArgumentException"><paramref name="offset is less than 0">offset is less than 0</paramref>. - or - <paramref name="offset">offset</paramref> is greater than the length of <paramref name="buffer">buffer</paramref>. - or - <paramref name="offset">offset</paramref> plus count is greater than the length of <paramref name="buffer">buffer</paramref>.</exception>
586 <exception cref="T:System.IO.IOException">The write operation failed. - or - Encryption is in use, but the data could not be encrypted.</exception>
587 <exception cref="T:System.NotSupportedException">There is already a write operation in progress.</exception>
588 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
589 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
591 <member name="P:System.Net.Security.NegotiateStream.WriteTimeout">
592 <summary>Gets or sets the amount of time a write operation blocks waiting for data.</summary>
593 <returns>A <see cref="T:System.Int32"></see> that specifies the amount of time that will elapse before a write operation fails.</returns>
595 <member name="T:System.Net.Security.ProtectionLevel">
596 <summary>Indicates the security services requested for an authenticated stream.</summary>
598 <member name="F:System.Net.Security.ProtectionLevel.EncryptAndSign">
599 <summary>Encrypt and sign data to help ensure the confidentiality and integrity of transmitted data.</summary>
602 <member name="F:System.Net.Security.ProtectionLevel.None">
603 <summary>Authentication only.</summary>
606 <member name="F:System.Net.Security.ProtectionLevel.Sign">
607 <summary>Sign data to help ensure the integrity of transmitted data.</summary>
610 <member name="T:System.Net.Security.RemoteCertificateValidationCallback">
611 <summary>Verifies the remote Secure Sockets Layer (SSL) certificate used for authentication.</summary>
612 <param name="sender">An object that contains state information for this validation.</param>
613 <param name="certificate">The certificate used to authenticate the remote party.</param>
614 <param name="chain">The chain of certificate authorities associated with the remote certificate.</param>
615 <param name="sslPolicyErrors">One or more errors associated with the remote certificate.</param>
618 <member name="T:System.Net.Security.SslStream">
619 <summary>Provides a stream used for client-server communication that uses the Secure Socket Layer (SSL) security protocol to authenticate the server and optionally the client.</summary>
621 <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream)">
622 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.SslStream"></see> class using the specified <see cref="T:System.IO.Stream"></see>.</summary>
623 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data.</param>
624 <exception cref="T:System.ArgumentException"><paramref name="innerStream">innerStream</paramref> is not readable. -or- <paramref name="innerStream">innerStream</paramref> is not writable.</exception>
625 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
627 <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean)">
628 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.SslStream"></see> class using the specified <see cref="T:System.IO.Stream"></see> and stream closure behavior.</summary>
629 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data.</param>
630 <param name="leaveInnerStreamOpen">A Boolean value that indicates the closure behavior of the <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data. This parameter indicates if the inner stream is left open.</param>
631 <exception cref="T:System.ArgumentException"><paramref name="innerStream">innerStream</paramref> is not readable. -or- <paramref name="innerStream">innerStream</paramref> is not writable.</exception>
632 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
634 <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback)">
635 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.SslStream"></see> class using the specified <see cref="T:System.IO.Stream"></see>, stream closure behavior and certificate validation delegate.</summary>
636 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data.</param>
637 <param name="leaveInnerStreamOpen">A Boolean value that indicates the closure behavior of the <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data. This parameter indicates if the inner stream is left open.</param>
638 <param name="userCertificateValidationCallback">A <see cref="T:System.Net.Security.RemoteCertificateValidationCallback"></see> delegate responsible for validating the certificate supplied by the remote party.</param>
639 <exception cref="T:System.ArgumentException"><paramref name="innerStream">innerStream</paramref> is not readable. -or- <paramref name="innerStream">innerStream</paramref> is not writable.</exception>
640 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
642 <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback,System.Net.Security.LocalCertificateSelectionCallback)">
643 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.SslStream"></see> class using the specified <see cref="T:System.IO.Stream"></see>, stream closure behavior, certificate validation delegate and certificate selection delegate.</summary>
644 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data.</param>
645 <param name="leaveInnerStreamOpen">A Boolean value that indicates the closure behavior of the <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data. This parameter indicates if the inner stream is left open.</param>
646 <param name="userCertificateValidationCallback">A <see cref="T:System.Net.Security.RemoteCertificateValidationCallback"></see> delegate responsible for validating the certificate supplied by the remote party.</param>
647 <param name="userCertificateSelectionCallback">A <see cref="T:System.Net.Security.LocalCertificateSelectionCallback"></see> delegate responsible for selecting the certificate used for authentication.</param>
648 <exception cref="T:System.ArgumentException"><paramref name="innerStream">innerStream</paramref> is not readable. -or- <paramref name="innerStream">innerStream</paramref> is not writable.</exception>
649 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
651 <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback,System.Net.Security.LocalCertificateSelectionCallback,System.Net.Security.EncryptionPolicy)">
652 <summary>Initializes a new instance of the <see cref="T:System.Net.Security.SslStream"></see> class using the specified <see cref="T:System.IO.Stream"></see></summary>
653 <param name="innerStream">A <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data.</param>
654 <param name="leaveInnerStreamOpen">A Boolean value that indicates the closure behavior of the <see cref="T:System.IO.Stream"></see> object used by the <see cref="T:System.Net.Security.SslStream"></see> for sending and receiving data. This parameter indicates if the inner stream is left open.</param>
655 <param name="userCertificateValidationCallback">A <see cref="T:System.Net.Security.RemoteCertificateValidationCallback"></see> delegate responsible for validating the certificate supplied by the remote party.</param>
656 <param name="userCertificateSelectionCallback">A <see cref="T:System.Net.Security.LocalCertificateSelectionCallback"></see> delegate responsible for selecting the certificate used for authentication.</param>
657 <param name="encryptionPolicy">The <see cref="T:System.Net.Security.EncryptionPolicy"></see> to use.</param>
658 <exception cref="T:System.ArgumentException"><paramref name="innerStream">innerStream</paramref> is not readable. -or- <paramref name="innerStream">innerStream</paramref> is not writable. -or- <paramref name="encryptionPolicy">encryptionPolicy</paramref> is not valid.</exception>
659 <exception cref="T:System.ArgumentNullException"><paramref name="innerStream">innerStream</paramref> is null. -or- <paramref name="innerStream">innerStream</paramref> is equal to <see cref="F:System.IO.Stream.Null"></see>.</exception>
661 <member name="M:System.Net.Security.SslStream.AuthenticateAsClient(System.String)">
662 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection.</summary>
663 <param name="targetHost">The name of the server that shares this <see cref="T:System.Net.Security.SslStream"></see>.</param>
664 <exception cref="T:System.ArgumentNullException"><paramref name="targetHost">targetHost</paramref> is null.</exception>
665 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
666 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
667 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
669 <member name="M:System.Net.Security.SslStream.AuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Boolean)">
670 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection. The authentication process uses the specified certificate collection, and the system default SSL protocol.</summary>
671 <param name="targetHost">The name of the server that will share this <see cref="T:System.Net.Security.SslStream"></see>.</param>
672 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> that contains client certificates.</param>
673 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
675 <member name="M:System.Net.Security.SslStream.AuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean)">
676 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection. The authentication process uses the specified certificate collection and SSL protocol.</summary>
677 <param name="targetHost">The name of the server that will share this <see cref="T:System.Net.Security.SslStream"></see>.</param>
678 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> that contains client certificates.</param>
679 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
680 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
682 <member name="M:System.Net.Security.SslStream.AuthenticateAsClientAsync(System.String)">
683 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection as an asynchronous operation.</summary>
684 <param name="targetHost">The name of the server that shares this <see cref="T:System.Net.Security.SslStream"></see>.</param>
685 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
686 <exception cref="T:System.ArgumentNullException"><paramref name="targetHost">targetHost</paramref> is null.</exception>
687 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
688 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
689 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
691 <member name="M:System.Net.Security.SslStream.AuthenticateAsClientAsync(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Boolean)">
692 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. The authentication process uses the specified certificate collection and the system default SSL protocol.</summary>
693 <param name="targetHost">The name of the server that will share this <see cref="T:System.Net.Security.SslStream"></see>.</param>
694 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> that contains client certificates.</param>
695 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
696 <returns>The task object representing the asynchronous operation.</returns>
698 <member name="M:System.Net.Security.SslStream.AuthenticateAsClientAsync(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean)">
699 <summary>Called by clients to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. The authentication process uses the specified certificate collection and SSL protocol.</summary>
700 <param name="targetHost">The name of the server that will share this <see cref="T:System.Net.Security.SslStream"></see>.</param>
701 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> that contains client certificates.</param>
702 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
703 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
704 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
706 <member name="M:System.Net.Security.SslStream.AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate)">
707 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate.</summary>
708 <param name="serverCertificate">The certificate used to authenticate the server.</param>
709 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
710 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
711 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Client authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
712 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
713 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
715 <member name="M:System.Net.Security.SslStream.AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Boolean)">
716 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates and requirements, and using the sytem default security protocol.</summary>
717 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
718 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
719 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
720 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
721 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
722 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Client authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
723 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
724 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
726 <member name="M:System.Net.Security.SslStream.AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Security.Authentication.SslProtocols,System.Boolean)">
727 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol.</summary>
728 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
729 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
730 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
731 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
732 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
733 <exception cref="T:System.ArgumentException"><paramref name="enabledSslProtocols">enabledSslProtocols</paramref> is not a valid <see cref="T:System.Security.Authentication.SslProtocols"></see> value.</exception>
734 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
735 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Client authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
736 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
737 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
739 <member name="M:System.Net.Security.SslStream.AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Security.Authentication.SslProtocols,System.Boolean)">
740 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.</summary>
741 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
742 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
743 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
744 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
745 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
747 <member name="M:System.Net.Security.SslStream.AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate)">
748 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate as an asynchronous operation.</summary>
749 <param name="serverCertificate">The certificate used to authenticate the server.</param>
750 <returns>Returns <see cref="T:System.Threading.Tasks.Task"></see> The task object representing the asynchronous operation.</returns>
751 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
752 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
753 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Client authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
754 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
755 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServerAsync"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
757 <member name="M:System.Net.Security.SslStream.AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Boolean)">
758 <summary>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.</summary>
759 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
760 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
761 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
762 <returns>The task object representing the asynchronous operation.</returns>
764 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsClient(System.String,System.AsyncCallback,System.Object)">
765 <summary>Called by clients to begin an asynchronous operation to authenticate the server and optionally the client.</summary>
766 <param name="targetHost">The name of the server that shares this <see cref="T:System.Net.Security.SslStream"></see>.</param>
767 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
768 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
769 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
770 <exception cref="T:System.ArgumentNullException"><paramref name="targetHost">targetHost</paramref> is null.</exception>
771 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
772 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
773 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
775 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Boolean,System.AsyncCallback,System.Object)">
776 <summary>Called by clients to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates and the system default security protocol.</summary>
777 <param name="targetHost">The name of the server that shares this <see cref="T:System.Net.Security.SslStream"></see>.</param>
778 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> containing client certificates.</param>
779 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
780 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
781 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
782 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
783 <exception cref="T:System.ArgumentNullException"><paramref name="targetHost">targetHost</paramref> is null.</exception>
784 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
785 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
786 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
788 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean,System.AsyncCallback,System.Object)">
789 <summary>Called by clients to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates and security protocol.</summary>
790 <param name="targetHost">The name of the server that shares this <see cref="T:System.Net.Security.SslStream"></see>.</param>
791 <param name="clientCertificates">The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> containing client certificates.</param>
792 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
793 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
794 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
795 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
796 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
797 <exception cref="T:System.ArgumentNullException"><paramref name="targetHost">targetHost</paramref> is null.</exception>
798 <exception cref="T:System.ArgumentException"><paramref name="enabledSslProtocols">enabledSslProtocols</paramref> is not a valid <see cref="T:System.Security.Authentication.SslProtocols"></see> value.</exception>
799 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
800 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
801 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
803 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.AsyncCallback,System.Object)">
804 <summary>Called by servers to begin an asynchronous operation to authenticate the client and optionally the server in a client-server connection.</summary>
805 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
806 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
807 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
808 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
809 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
810 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
811 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Client authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
812 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
813 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
815 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Boolean,System.AsyncCallback,System.Object)">
816 <summary>Called by servers to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates and requirements, and the system default security protocol.</summary>
817 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
818 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
819 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
820 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
821 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
822 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
823 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
824 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
825 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
826 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
827 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
829 <member name="M:System.Net.Security.SslStream.BeginAuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Security.Authentication.SslProtocols,System.Boolean,System.AsyncCallback,System.Object)">
830 <summary>Called by servers to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates, requirements and security protocol.</summary>
831 <param name="serverCertificate">The X509Certificate used to authenticate the server.</param>
832 <param name="clientCertificateRequired">A <see cref="T:System.Boolean"></see> value that specifies whether the client is asked for a certificate for authentication. Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.</param>
833 <param name="enabledSslProtocols">The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</param>
834 <param name="checkCertificateRevocation">A <see cref="T:System.Boolean"></see> value that specifies whether the certificate revocation list is checked during authentication.</param>
835 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the authentication is complete.</param>
836 <param name="asyncState">A user-defined object that contains information about the operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
837 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
838 <exception cref="T:System.ArgumentNullException"><paramref name="serverCertificate">serverCertificate</paramref> is null.</exception>
839 <exception cref="T:System.ArgumentException"><paramref name="enabledSslProtocols">enabledSslProtocols</paramref> is not a valid <see cref="T:System.Security.Authentication.SslProtocols"></see> value.</exception>
840 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
841 <exception cref="T:System.InvalidOperationException">Authentication has already occurred. -or- Server authentication using this <see cref="T:System.Net.Security.SslStream"></see> was tried previously. -or- Authentication is already in progress.</exception>
842 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
843 <exception cref="T:System.PlatformNotSupportedException">The <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see> method is not supported on Windows 95, Windows 98, or Windows Millennium.</exception>
845 <member name="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)">
846 <summary>Begins an asynchronous read operation that reads data from the stream and stores it in the specified array.</summary>
847 <param name="buffer">A <see cref="T:System.Byte"></see> array that receives the bytes read from the stream.</param>
848 <param name="offset">The zero-based location in buffer at which to begin storing the data read from this stream.</param>
849 <param name="count">The maximum number of bytes to read from the stream.</param>
850 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the read operation is complete.</param>
851 <param name="asyncState">A user-defined object that contains information about the read operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
852 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
853 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
854 <exception cref="T:System.ArgumentException"><paramref name="offset">offset</paramref>
855 <paramref name="<"><</paramref>
856 <paramref name="0">0</paramref>. <paramref name="-or-">-or-</paramref><paramref name="offset">offset</paramref> > the length of <paramref name="buffer">buffer</paramref>. -or- <paramref name="offset">offset</paramref> + count > the length of <paramref name="buffer">buffer</paramref>.</exception>
857 <exception cref="T:System.IO.IOException">The read operation failed. -or- Encryption is in use, but the data could not be decrypted.</exception>
858 <exception cref="T:System.NotSupportedException">There is already a read operation in progress.</exception>
859 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
860 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
862 <member name="M:System.Net.Security.SslStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)">
863 <summary>Begins an asynchronous write operation that writes <see cref="T:System.Byte"></see>s from the specified buffer to the stream.</summary>
864 <param name="buffer">A <see cref="T:System.Byte"></see> array that supplies the bytes to be written to the stream.</param>
865 <param name="offset">The zero-based location in buffer at which to begin reading bytes to be written to the stream.</param>
866 <param name="count">An <see cref="T:System.Int32"></see> value that specifies the number of bytes to read from buffer.</param>
867 <param name="asyncCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the write operation is complete.</param>
868 <param name="asyncState">A user-defined object that contains information about the write operation. This object is passed to the asyncCallback delegate when the operation completes.</param>
869 <returns>An <see cref="T:System.IAsyncResult"></see> object indicating the status of the asynchronous operation.</returns>
870 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
871 <exception cref="T:System.ArgumentException"><paramref name="offset">offset</paramref>
872 <paramref name="<"><</paramref>
873 <paramref name="0">0</paramref>. <paramref name="-or-">-or-</paramref><paramref name="offset">offset</paramref> > the length of <paramref name="buffer">buffer</paramref>. -or- <paramref name="offset">offset</paramref> + count > the length of <paramref name="buffer">buffer</paramref>.</exception>
874 <exception cref="T:System.IO.IOException">The write operation failed.</exception>
875 <exception cref="T:System.NotSupportedException">There is already a write operation in progress.</exception>
876 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
877 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
879 <member name="P:System.Net.Security.SslStream.CanRead">
880 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is readable.</summary>
881 <returns>true if authentication has occurred and the underlying stream is readable; otherwise false.</returns>
883 <member name="P:System.Net.Security.SslStream.CanSeek">
884 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is seekable.</summary>
885 <returns>This property always returns false.</returns>
887 <member name="P:System.Net.Security.SslStream.CanTimeout">
888 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream supports time-outs.</summary>
889 <returns>true if the underlying stream supports time-outs; otherwise, false.</returns>
891 <member name="P:System.Net.Security.SslStream.CanWrite">
892 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the underlying stream is writable.</summary>
893 <returns>true if authentication has occurred and the underlying stream is writable; otherwise false.</returns>
895 <member name="P:System.Net.Security.SslStream.CheckCertRevocationStatus">
896 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the certificate revocation list is checked during the certificate validation process.</summary>
897 <returns>true if the certificate revocation list is checked; otherwise, false.</returns>
899 <member name="P:System.Net.Security.SslStream.CipherAlgorithm">
900 <summary>Gets a value that identifies the bulk encryption algorithm used by this <see cref="T:System.Net.Security.SslStream"></see>.</summary>
901 <returns>A <see cref="T:System.Security.Authentication.CipherAlgorithmType"></see> value.</returns>
902 <exception cref="T:System.InvalidOperationException">The <see cref="P:System.Net.Security.SslStream.CipherAlgorithm"></see> property was accessed before the completion of the authentication process or the authentication process failed.</exception>
904 <member name="P:System.Net.Security.SslStream.CipherStrength">
905 <summary>Gets a value that identifies the strength of the cipher algorithm used by this <see cref="T:System.Net.Security.SslStream"></see>.</summary>
906 <returns>An <see cref="T:System.Int32"></see> value that specifies the strength of the algorithm, in bits.</returns>
908 <member name="M:System.Net.Security.SslStream.Dispose(System.Boolean)">
909 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.Security.SslStream"></see> and optionally releases the managed resources.</summary>
910 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
912 <member name="M:System.Net.Security.SslStream.EndAuthenticateAsClient(System.IAsyncResult)">
913 <summary>Ends a pending asynchronous server authentication operation started with a previous call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see>.</summary>
914 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see>.</param>
915 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
916 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsServer"></see>.</exception>
917 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
918 <exception cref="T:System.InvalidOperationException">There is no pending server authentication to complete.</exception>
920 <member name="M:System.Net.Security.SslStream.EndAuthenticateAsServer(System.IAsyncResult)">
921 <summary>Ends a pending asynchronous client authentication operation started with a previous call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsClient"></see>.</summary>
922 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsClient"></see>.</param>
923 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
924 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="Overload:System.Net.Security.SslStream.BeginAuthenticateAsClient"></see>.</exception>
925 <exception cref="T:System.Security.Authentication.AuthenticationException">The authentication failed and left this object in an unusable state.</exception>
926 <exception cref="T:System.InvalidOperationException">There is no pending client authentication to complete.</exception>
928 <member name="M:System.Net.Security.SslStream.EndRead(System.IAsyncResult)">
929 <summary>Ends an asynchronous read operation started with a previous call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</summary>
930 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see></param>
931 <returns>A <see cref="T:System.Int32"></see> value that specifies the number of bytes read from the underlying stream.</returns>
932 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
933 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</exception>
934 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
935 <exception cref="T:System.IO.IOException">The read operation failed.</exception>
937 <member name="M:System.Net.Security.SslStream.EndWrite(System.IAsyncResult)">
938 <summary>Ends an asynchronous write operation started with a previous call to <see cref="M:System.Net.Security.SslStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</summary>
939 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> instance returned by a call to <see cref="M:System.Net.Security.SslStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see></param>
940 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
941 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not created by a call to <see cref="M:System.Net.Security.SslStream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)"></see>.</exception>
942 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
943 <exception cref="T:System.IO.IOException">The write operation failed.</exception>
945 <member name="M:System.Net.Security.SslStream.Flush">
946 <summary>Causes any buffered data to be written to the underlying device.</summary>
948 <member name="M:System.Net.Security.SslStream.FlushAsync(System.Threading.CancellationToken)">
949 <param name="cancellationToken"></param>
952 <member name="P:System.Net.Security.SslStream.HashAlgorithm">
953 <summary>Gets the algorithm used for generating message authentication codes (MACs).</summary>
954 <returns>A <see cref="T:System.Security.Authentication.HashAlgorithmType"></see> value.</returns>
955 <exception cref="T:System.InvalidOperationException">The <see cref="P:System.Net.Security.SslStream.HashAlgorithm"></see> property was accessed before the completion of the authentication process or the authentication process failed.</exception>
957 <member name="P:System.Net.Security.SslStream.HashStrength">
958 <summary>Gets a value that identifies the strength of the hash algorithm used by this instance.</summary>
959 <returns>An <see cref="T:System.Int32"></see> value that specifies the strength of the <see cref="T:System.Security.Authentication.HashAlgorithmType"></see> algorithm, in bits. Valid values are 128 or 160.</returns>
961 <member name="P:System.Net.Security.SslStream.IsAuthenticated">
962 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether authentication was successful.</summary>
963 <returns>true if successful authentication occurred; otherwise, false.</returns>
965 <member name="P:System.Net.Security.SslStream.IsEncrypted">
966 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether this <see cref="T:System.Net.Security.SslStream"></see> uses data encryption.</summary>
967 <returns>true if data is encrypted before being transmitted over the network and decrypted when it reaches the remote endpoint; otherwise false.</returns>
969 <member name="P:System.Net.Security.SslStream.IsMutuallyAuthenticated">
970 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether both server and client have been authenticated.</summary>
971 <returns>true if the server has been authenticated; otherwise false.</returns>
973 <member name="P:System.Net.Security.SslStream.IsServer">
974 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the local side of the connection used by this <see cref="T:System.Net.Security.SslStream"></see> was authenticated as the server.</summary>
975 <returns>true if the local endpoint was successfully authenticated as the server side of the authenticated connection; otherwise false.</returns>
977 <member name="P:System.Net.Security.SslStream.IsSigned">
978 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the data sent using this stream is signed.</summary>
979 <returns>true if the data is signed before being transmitted; otherwise false.</returns>
981 <member name="P:System.Net.Security.SslStream.KeyExchangeAlgorithm">
982 <summary>Gets the key exchange algorithm used by this <see cref="T:System.Net.Security.SslStream"></see>.</summary>
983 <returns>An <see cref="T:System.Security.Authentication.ExchangeAlgorithmType"></see> value.</returns>
985 <member name="P:System.Net.Security.SslStream.KeyExchangeStrength">
986 <summary>Gets a value that identifies the strength of the key exchange algorithm used by this instance.</summary>
987 <returns>An <see cref="T:System.Int32"></see> value that specifies the strength of the <see cref="T:System.Security.Authentication.ExchangeAlgorithmType"></see> algorithm, in bits.</returns>
989 <member name="P:System.Net.Security.SslStream.Length">
990 <summary>Gets the length of the underlying stream.</summary>
991 <returns>A <see cref="T:System.Int64"></see>. The length of the underlying stream.</returns>
992 <exception cref="T:System.NotSupportedException">Getting the value of this property is not supported when the underlying stream is a <see cref="T:System.Net.Sockets.NetworkStream"></see>.</exception>
994 <member name="P:System.Net.Security.SslStream.LocalCertificate">
995 <summary>Gets the certificate used to authenticate the local endpoint.</summary>
996 <returns>An X509Certificate object that represents the certificate supplied for authentication or null if no certificate was supplied.</returns>
997 <exception cref="T:System.InvalidOperationException">Authentication failed or has not occurred.</exception>
999 <member name="P:System.Net.Security.SslStream.Position">
1000 <summary>Gets or sets the current position in the underlying stream.</summary>
1001 <returns>A <see cref="T:System.Int64"></see>. The current position in the underlying stream.</returns>
1002 <exception cref="T:System.NotSupportedException">Setting this property is not supported. -or- Getting the value of this property is not supported when the underlying stream is a <see cref="T:System.Net.Sockets.NetworkStream"></see>.</exception>
1004 <member name="M:System.Net.Security.SslStream.Read(System.Byte[],System.Int32,System.Int32)">
1005 <summary>Reads data from this stream and stores it in the specified array.</summary>
1006 <param name="buffer">A <see cref="T:System.Byte"></see> array that receives the bytes read from this stream.</param>
1007 <param name="offset">A <see cref="T:System.Int32"></see> that contains the zero-based location in buffer at which to begin storing the data read from this stream.</param>
1008 <param name="count">A <see cref="T:System.Int32"></see> that contains the maximum number of bytes to read from this stream.</param>
1009 <returns>A <see cref="T:System.Int32"></see> value that specifies the number of bytes read. When there is no more data to be read, returns 0.</returns>
1010 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
1011 <exception cref="T:System.ArgumentException"><paramref name="offset">offset</paramref>
1012 <paramref name="<"><</paramref>
1013 <paramref name="0">0</paramref>. <paramref name="-or-">-or-</paramref><paramref name="offset">offset</paramref> > the length of <paramref name="buffer">buffer</paramref>. -or- <paramref name="offset">offset</paramref> + count > the length of <paramref name="buffer">buffer</paramref>.</exception>
1014 <exception cref="T:System.IO.IOException">The read operation failed. Check the inner exception, if present to determine the cause of the failure.</exception>
1015 <exception cref="T:System.NotSupportedException">There is already a read operation in progress.</exception>
1016 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
1017 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
1019 <member name="P:System.Net.Security.SslStream.ReadTimeout">
1020 <summary>Gets or sets the amount of time a read operation blocks waiting for data.</summary>
1021 <returns>A <see cref="T:System.Int32"></see> that specifies the amount of time that elapses before a synchronous read operation fails.</returns>
1023 <member name="P:System.Net.Security.SslStream.RemoteCertificate">
1024 <summary>Gets the certificate used to authenticate the remote endpoint.</summary>
1025 <returns>An X509Certificate object that represents the certificate supplied for authentication or null if no certificate was supplied.</returns>
1026 <exception cref="T:System.InvalidOperationException">Authentication failed or has not occurred.</exception>
1028 <member name="M:System.Net.Security.SslStream.Seek(System.Int64,System.IO.SeekOrigin)">
1029 <summary>Throws a <see cref="T:System.NotSupportedException"></see>.</summary>
1030 <param name="offset">This value is ignored.</param>
1031 <param name="origin">This value is ignored.</param>
1032 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
1033 <exception cref="T:System.NotSupportedException">Seeking is not supported by <see cref="T:System.Net.Security.SslStream"></see> objects.</exception>
1035 <member name="M:System.Net.Security.SslStream.SetLength(System.Int64)">
1036 <summary>Sets the length of the underlying stream.</summary>
1037 <param name="value">An <see cref="T:System.Int64"></see> value that specifies the length of the stream.</param>
1039 <member name="M:System.Net.Security.SslStream.ShutdownAsync">
1040 <summary>Shuts down this SslStream.</summary>
1041 <returns>The task object representing the asynchronous operation.</returns>
1043 <member name="P:System.Net.Security.SslStream.SslProtocol">
1044 <summary>Gets a value that indicates the security protocol used to authenticate this connection.</summary>
1045 <returns>The <see cref="T:System.Security.Authentication.SslProtocols"></see> value that represents the protocol used for authentication.</returns>
1047 <member name="P:System.Net.Security.SslStream.TransportContext">
1048 <summary>Gets the <see cref="T:System.Net.TransportContext"></see> used for authentication using extended protection.</summary>
1049 <returns>The <see cref="T:System.Net.TransportContext"></see> object that contains the channel binding token (CBT) used for extended protection.</returns>
1051 <member name="M:System.Net.Security.SslStream.Write(System.Byte[])">
1052 <summary>Writes the specified data to this stream.</summary>
1053 <param name="buffer">A <see cref="T:System.Byte"></see> array that supplies the bytes written to the stream.</param>
1054 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
1055 <exception cref="T:System.IO.IOException">The write operation failed.</exception>
1056 <exception cref="T:System.NotSupportedException">There is already a write operation in progress.</exception>
1057 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
1058 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
1060 <member name="M:System.Net.Security.SslStream.Write(System.Byte[],System.Int32,System.Int32)">
1061 <summary>Write the specified number of <see cref="T:System.Byte"></see>s to the underlying stream using the specified buffer and offset.</summary>
1062 <param name="buffer">A <see cref="T:System.Byte"></see> array that supplies the bytes written to the stream.</param>
1063 <param name="offset">A <see cref="T:System.Int32"></see> that contains the zero-based location in buffer at which to begin reading bytes to be written to the stream.</param>
1064 <param name="count">A <see cref="T:System.Int32"></see> that contains the number of bytes to read from buffer.</param>
1065 <exception cref="T:System.ArgumentNullException"><paramref name="buffer">buffer</paramref> is null.</exception>
1066 <exception cref="T:System.ArgumentException"><paramref name="offset">offset</paramref>
1067 <paramref name="<"><</paramref>
1068 <paramref name="0">0</paramref>. <paramref name="-or-">-or-</paramref><paramref name="offset">offset</paramref> > the length of <paramref name="buffer">buffer</paramref>. -or- <paramref name="offset">offset</paramref> + count > the length of <paramref name="buffer">buffer</paramref>.</exception>
1069 <exception cref="T:System.IO.IOException">The write operation failed.</exception>
1070 <exception cref="T:System.NotSupportedException">There is already a write operation in progress.</exception>
1071 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
1072 <exception cref="T:System.InvalidOperationException">Authentication has not occurred.</exception>
1074 <member name="P:System.Net.Security.SslStream.WriteTimeout">
1075 <summary>Gets or sets the amount of time a write operation blocks waiting for data.</summary>
1076 <returns>A <see cref="T:System.Int32"></see> that specifies the amount of time that elapses before a synchronous write operation fails.</returns>
1078 <member name="T:System.Security.Authentication.AuthenticationException">
1079 <summary>The exception that is thrown when authentication fails for an authentication stream.</summary>
1081 <member name="M:System.Security.Authentication.AuthenticationException.#ctor">
1082 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.AuthenticationException"></see> class with no message.</summary>
1084 <member name="M:System.Security.Authentication.AuthenticationException.#ctor(System.String)">
1085 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.AuthenticationException"></see> class with the specified message.</summary>
1086 <param name="message">A <see cref="T:System.String"></see> that describes the authentication failure.</param>
1088 <member name="M:System.Security.Authentication.AuthenticationException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1089 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.AuthenticationException"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
1090 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance that contains the information required to deserialize the new <see cref="T:System.Security.Authentication.AuthenticationException"></see> instance.</param>
1091 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> instance.</param>
1093 <member name="M:System.Security.Authentication.AuthenticationException.#ctor(System.String,System.Exception)">
1094 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.AuthenticationException"></see> class with the specified message and inner exception.</summary>
1095 <param name="message">A <see cref="T:System.String"></see> that describes the authentication failure.</param>
1096 <param name="innerException">The <see cref="T:System.Exception"></see> that is the cause of the current exception.</param>
1098 <member name="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy">
1099 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class represents the extended protection policy used by the server to validate incoming client connections.</summary>
1101 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement)">
1102 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class that specifies when the extended protection policy should be enforced.</summary>
1103 <param name="policyEnforcement">A <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> value that indicates when the extended protection policy should be enforced.</param>
1105 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1106 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class from a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that contains the required data to populate the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see>.</summary>
1107 <param name="info">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance that contains the information that is required to serialize the new <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> instance.</param>
1108 <param name="context">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> instance.</param>
1110 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ChannelBinding)">
1111 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class that specifies when the extended protection policy should be enforced and the channel binding token (CBT) to be used.</summary>
1112 <param name="policyEnforcement">A <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> value that indicates when the extended protection policy should be enforced.</param>
1113 <param name="customChannelBinding">A <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that contains a custom channel binding to use for validation.</param>
1114 <exception cref="T:System.ArgumentException"><paramref name="policyEnforcement">policyEnforcement</paramref> is specified as <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never"></see>.</exception>
1115 <exception cref="T:System.ArgumentNullException"><paramref name="customChannelBinding">customChannelBinding</paramref> is null.</exception>
1117 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ProtectionScenario,System.Collections.ICollection)">
1118 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class that specifies when the extended protection policy should be enforced, the kind of protection enforced by the policy, and a custom Service Provider Name (SPN) list that is used to match against a client's SPN.</summary>
1119 <param name="policyEnforcement">A <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> value that indicates when the extended protection policy should be enforced.</param>
1120 <param name="protectionScenario">A <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario"></see> value that indicates the kind of protection enforced by the policy.</param>
1121 <param name="customServiceNames">A <see cref="T:System.Collections.ICollection"></see> that contains the custom SPN list that is used to match against a client's SPN.</param>
1122 <exception cref="T:System.ArgumentException"><paramref name="policyEnforcement">policyEnforcement</paramref> is specified as <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never"></see>.</exception>
1123 <exception cref="T:System.ArgumentNullException"><paramref name="customServiceNames">customServiceNames</paramref> is null or an empty list.</exception>
1125 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ProtectionScenario,System.Security.Authentication.ExtendedProtection.ServiceNameCollection)">
1126 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> class that specifies when the extended protection policy should be enforced, the kind of protection enforced by the policy, and a custom Service Provider Name (SPN) list that is used to match against a client's SPN.</summary>
1127 <param name="policyEnforcement">A <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> value that indicates when the extended protection policy should be enforced.</param>
1128 <param name="protectionScenario">A <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario"></see> value that indicates the kind of protection enforced by the policy.</param>
1129 <param name="customServiceNames">A <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> that contains the custom SPN list that is used to match against a client's SPN.</param>
1130 <exception cref="T:System.ArgumentException"><paramref name="policyEnforcement">policyEnforcement</paramref> is specified as <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never"></see>.</exception>
1131 <exception cref="T:System.ArgumentNullException"><paramref name="customServiceNames">customServiceNames</paramref> is null or an empty list.</exception>
1133 <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding">
1134 <summary>Gets a custom channel binding token (CBT) to use for validation.</summary>
1135 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding"></see> that contains a custom channel binding to use for validation.</returns>
1137 <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames">
1138 <summary>Gets the custom Service Provider Name (SPN) list used to match against a client's SPN.</summary>
1139 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> that contains the custom SPN list that is used to match against a client's SPN.</returns>
1141 <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.OSSupportsExtendedProtection">
1142 <summary>Indicates whether the operating system supports integrated windows authentication with extended protection.</summary>
1143 <returns>true if the operating system supports integrated windows authentication with extended protection, otherwise false.</returns>
1145 <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.PolicyEnforcement">
1146 <summary>Gets when the extended protection policy should be enforced.</summary>
1147 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> value that indicates when the extended protection policy should be enforced.</returns>
1149 <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.ProtectionScenario">
1150 <summary>Gets the kind of protection enforced by the extended protection policy.</summary>
1151 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario"></see> value that indicates the kind of protection enforced by the policy.</returns>
1153 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.ToString">
1154 <summary>Gets a string representation for the extended protection policy instance.</summary>
1155 <returns>A <see cref="T:System.String"></see> instance that contains the representation of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> instance.</returns>
1157 <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1158 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object with the required data to serialize an <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> object.</summary>
1159 <param name="info">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that holds the serialized data for an <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> object.</param>
1160 <param name="context">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the destination of the serialized stream that is associated with the new <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see>.</param>
1162 <member name="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement">
1163 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement"></see> enumeration specifies when the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> should be enforced.</summary>
1165 <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always">
1166 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> is always enforced. Clients that don’t support extended protection will fail to authenticate.</summary>
1169 <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never">
1170 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> is never enforced and extended protection is disabled.</summary>
1173 <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.WhenSupported">
1174 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> is enforced only if the client and server supports extended protection.</summary>
1177 <member name="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario">
1178 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario"></see> enumeration specifies the protection scenario enforced by the policy.</summary>
1180 <member name="F:System.Security.Authentication.ExtendedProtection.ProtectionScenario.TransportSelected">
1181 <summary>The transport will select between a secure and standard protection scenario depending on the type of channel used. For secure protection, integrated Windows authentication is wrapped in a secure channel and has an exactly matching channel binding token with no Service Provider Name (SPN) validation. For standard protection, integrated Windows authentication is optionally wrapped in a secure channel with an optional channel binding token and SPN validation is required. So if the request comes through a secure channel, the channel binding token (CBT) is checked, otherwise the SPN is checked.</summary>
1184 <member name="F:System.Security.Authentication.ExtendedProtection.ProtectionScenario.TrustedProxy">
1185 <summary>Integrated Windows authentication is wrapped in a secure channel terminated by a trusted proxy and has a channel binding token with SPN validation required. This requires the presence of a CBT, but the CBT is not checked while the SPN is checked.</summary>
1188 <member name="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection">
1189 <summary>The <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> class is a read-only collection of service principal names.</summary>
1191 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.#ctor(System.Collections.ICollection)">
1192 <summary>Initializes a new read-only instance of the <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> class based on an existing <see cref="T:System.Collections.ICollection"></see>.</summary>
1193 <param name="items">An instance of the <see cref="T:System.Collections.ICollection"></see> class that contains the specified values of service names to be used to initialize the class.</param>
1194 <exception cref="T:System.ArgumentNullException"><paramref name="item">item</paramref> is null.</exception>
1195 <exception cref="T:System.ArgumentException"><paramref name="item">item</paramref> is empty.</exception>
1197 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Contains(System.String)">
1198 <summary>Returns a value indicating whether the specified string occurs within this <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance.</summary>
1199 <param name="searchServiceName">The string to seek.</param>
1200 <returns>Returns <see cref="T:System.Boolean"></see>. true if the <paramref name="searchServiceName">searchServiceName</paramref> parameter occurs within this <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance; otherwise, false.</returns>
1202 <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Count">
1205 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.GetEnumerator">
1208 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Merge(System.Collections.IEnumerable)">
1209 <summary>Merges the current <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> with the specified values to create a new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> containing the union.</summary>
1210 <param name="serviceNames">An instance of the <see cref="T:System.Collections.IEnumerable"></see> class that contains the specified values of service names to be merged.</param>
1211 <returns>A new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance that contains the union of the existing <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance merged with the specified values.</returns>
1212 <exception cref="T:System.ArgumentNullException"><paramref name="serviceNames">serviceNames</paramref> is null.</exception>
1213 <exception cref="T:System.ArgumentException"><paramref name="serviceNames">serviceNames</paramref> is empty.</exception>
1215 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Merge(System.String)">
1216 <summary>Merges the current <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> with the specified values to create a new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> containing the union.</summary>
1217 <param name="serviceName">A string that contains the specified values of service names to be used to initialize the class.</param>
1218 <returns>A new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance that contains the union of the existing <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> instance merged with the specified values.</returns>
1219 <exception cref="T:System.ArgumentNullException"><paramref name="serviceNames">serviceNames</paramref> is null.</exception>
1220 <exception cref="T:System.ArgumentException"><paramref name="serviceNames">serviceNames</paramref> is empty.</exception>
1222 <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#CopyTo(System.Array,System.Int32)">
1223 <param name="array"></param>
1224 <param name="index"></param>
1226 <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#IsSynchronized">
1229 <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#SyncRoot">
1232 <member name="T:System.Security.Authentication.InvalidCredentialException">
1233 <summary>The exception that is thrown when authentication fails for an authentication stream and cannot be retried.</summary>
1235 <member name="M:System.Security.Authentication.InvalidCredentialException.#ctor">
1236 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.InvalidCredentialException"></see> class with no message.</summary>
1238 <member name="M:System.Security.Authentication.InvalidCredentialException.#ctor(System.String)">
1239 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.InvalidCredentialException"></see> class with the specified message.</summary>
1240 <param name="message">A <see cref="T:System.String"></see> that describes the authentication failure.</param>
1242 <member name="M:System.Security.Authentication.InvalidCredentialException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1243 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.InvalidCredentialException"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
1244 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance that contains the information required to deserialize the new <see cref="T:System.Security.Authentication.InvalidCredentialException"></see> instance.</param>
1245 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> instance.</param>
1247 <member name="M:System.Security.Authentication.InvalidCredentialException.#ctor(System.String,System.Exception)">
1248 <summary>Initializes a new instance of the <see cref="T:System.Security.Authentication.InvalidCredentialException"></see> class with the specified message and inner exception.</summary>
1249 <param name="message">A <see cref="T:System.String"></see> that describes the authentication failure.</param>
1250 <param name="innerException">The <see cref="T:System.Exception"></see> that is the cause of the current exception.</param>