BeginChangeCertificate Method (String, Byte[], AsyncCallback, Object)
Changes the certificate to be used dynamically.
Namespace: Microsoft.Rtc.Collaboration
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Public Function BeginChangeCertificate ( _
certificateIssuerName As String, _
certificateSerialNumber As Byte(), _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As CollaborationPlatform
Dim certificateIssuerName As String
Dim certificateSerialNumber As Byte()
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginChangeCertificate(certificateIssuerName, _
certificateSerialNumber, userCallback, _
state)
public IAsyncResult BeginChangeCertificate(
string certificateIssuerName,
byte[] certificateSerialNumber,
AsyncCallback userCallback,
Object state
)
Parameters
- certificateIssuerName
Type: System..::..String
- certificateSerialNumber
Type: array<System..::..Byte>[]()[][]
- userCallback
Type: System..::..AsyncCallback
- state
Type: System..::..Object
Return Value
Type: System..::..IAsyncResult
Remarks
This requires the platform to stop listening, change the certificate, and start listening again. While it does not affect existing connections, the application should expect that there could a temporary problem in accepting new incoming connections.
Exceptions
[cref][T:System.InvalidOperationException]: Thrown when the platform has not been configured with mutual Tls.
[cref][T:System.InvalidOperationException]: Thrown when the platform is not in the correct state to change certificates.
[cref][T:System.ArgumentNullException]: Thrown if one or more arguments are null.
[cref][T:System.ArgumentException]: Thrown if one of more arguments are invalid.
[cref][T:Microsoft.Rtc.Signaling.TlsFailureException]: Thrown if certificate is invalid or otherwise unusable.