CollaborationPlatform.BeginChangeCertificate Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| BeginChangeCertificate(X509Certificate, AsyncCallback, Object) |
Dynamically changes the certificate to be used. |
| BeginChangeCertificate(String, Byte[], AsyncCallback, Object) |
Dynamically changes the certificate to be used. |
BeginChangeCertificate(X509Certificate, AsyncCallback, Object)
Dynamically changes the certificate to be used.
public:
IAsyncResult ^ BeginChangeCertificate(System::Security::Cryptography::X509Certificates::X509Certificate ^ certificate, AsyncCallback ^ userCallback, System::Object ^ state);public IAsyncResult BeginChangeCertificate (System.Security.Cryptography.X509Certificates.X509Certificate certificate, AsyncCallback userCallback, object state);member this.BeginChangeCertificate : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResultPublic Function BeginChangeCertificate (certificate As X509Certificate, userCallback As AsyncCallback, state As Object) As IAsyncResultParameters
- certificate
- X509Certificate
The new certificate.
- userCallback
- AsyncCallback
The method to be called when the asynchronous operation is completed.
- state
- Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.
Returns
Exceptions
Thrown when the platform is not in the correct state to change the certificate.
Thrown when one or more of the arguments are null.
Thrown when the certificate is invalid or otherwise unusable.
Remarks
For auto-provisioned platforms this method need not be used since certificate changes are automatically applied.
In order to change the certficate, the platform needs to stop listening, change the certificate, and start listening again. While this does not affect existing connections, there could be a temporary problem in accepting new incoming connections.
Applies to
BeginChangeCertificate(String, Byte[], AsyncCallback, Object)
Dynamically changes the certificate to be used.
public:
IAsyncResult ^ BeginChangeCertificate(System::String ^ certificateIssuerName, cli::array <System::Byte> ^ certificateSerialNumber, AsyncCallback ^ userCallback, System::Object ^ state);public IAsyncResult BeginChangeCertificate (string certificateIssuerName, byte[] certificateSerialNumber, AsyncCallback userCallback, object state);member this.BeginChangeCertificate : string * byte[] * AsyncCallback * obj -> IAsyncResultPublic Function BeginChangeCertificate (certificateIssuerName As String, certificateSerialNumber As Byte(), userCallback As AsyncCallback, state As Object) As IAsyncResultParameters
- certificateIssuerName
- String
The issuer name for the new certificate.
- certificateSerialNumber
- Byte[]
The serial number for the new certificate.
- userCallback
- AsyncCallback
The method to be called when the asynchronous operation is completed.
- state
- Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.
Returns
An IAsyncResult that references the asynchronous operation.
Exceptions
Thrown when the platform is not in the correct state to change the certificate.
Thrown when one of more arguments are null.
Thrown when one or more of the arguments are invalid.
Thrown when the certificate is invalid or unusable.
Remarks
For auto-provisioned platforms this method need not be used since certificate changes are automatically applied.
In order to change the certficate, the platform needs to stop listening, change the certificate, and start listening again. While this does not affect existing connections, there could be a temporary problem in accepting new incoming connections.