QuickOPC User's Guide and Reference
BeginObtainNewCertificate(IEasyUAApplication,UAEndpointDescriptor) Method



OpcLabs.EasyOpcUA Assembly > OpcLabs.EasyOpc.UA.Application.Extensions Namespace > IEasyUAApplicationExtension Class > BeginObtainNewCertificate Method : BeginObtainNewCertificate(IEasyUAApplication,UAEndpointDescriptor) Method
The OPC UA client application object that will perform the operation.
The GDS endpoint acting as OPC UA certificate manager (CM).
Begins an asynchronous operation that obtains a new application instance certificate from the certificate manager, and stores it for subsequent usage.
Syntax
'Declaration
 
<ExtensionAttribute()>
<NotNullAttribute()>
Public Overloads Shared Function BeginObtainNewCertificate( _
   ByVal application As IEasyUAApplication, _
   ByVal gdsEndpointDescriptor As UAEndpointDescriptor _
) As IAsyncResult
'Usage
 
Dim application As IEasyUAApplication
Dim gdsEndpointDescriptor As UAEndpointDescriptor
Dim value As IAsyncResult
 
value = IEasyUAApplicationExtension.BeginObtainNewCertificate(application, gdsEndpointDescriptor)
[Extension()]
[NotNull()]
public static IAsyncResult BeginObtainNewCertificate( 
   IEasyUAApplication application,
   UAEndpointDescriptor gdsEndpointDescriptor
)
[Extension()]
[NotNull()]
public:
static IAsyncResult^ BeginObtainNewCertificate( 
   IEasyUAApplication^ application,
   UAEndpointDescriptor^ gdsEndpointDescriptor
) 

Parameters

application
The OPC UA client application object that will perform the operation.
gdsEndpointDescriptor
The GDS endpoint acting as OPC UA certificate manager (CM).
Exceptions
ExceptionDescription
A null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.
Remarks

The operation is asynchronous, because it involves multiple steps, and waiting for a finalization of the request by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method). End of the operation is handled by the EndObtainNewCertificate method. The operation can be cancelled using the CancelObtainNewCertificate method.

For a synchronous alternative, see the ObtainNewCertificate(IEasyUAApplication,UAEndpointDescriptor) extension method and its overloads.

For a task-based asynchronous programming pattern alternative, see the ObtainNewCertificateAsync(IEasyUAApplication,UAEndpointDescriptor) extension method and its overloads.

Requirements

Target Platforms: .NET Framework: Windows 10 (selected versions), Windows 11 (selected versions), Windows Server 2012 R2, Windows Server 2016; .NET Core, .NET 6: Linux, macOS, Microsoft Windows

See Also