Connectivity Software User's Guide and Reference
DemandsPreselection Method (UAEndpointDescriptor)



OpcLabs.EasyOpcUAPrimitives Assembly > OpcLabs.EasyOpc.UA Namespace > UAEndpointDescriptor Class : DemandsPreselection Method
The effective endpoint selection policy to evaluate.

Because the OpcLabs.EasyOpc.UA.Engine.UAEndpointSelectionPolicy has an implicit conversion from OpcLabs.EasyOpc.UA.Engine.UAMessageSecurityModes, in languages that support implicit conversion operators (such as C# or VB.NET), you can simply use a OpcLabs.EasyOpc.UA.Engine.UAMessageSecurityModes in place of this parameter, and the corresponding OPC UA endpoint selection policy will be constructed automatically. When the implicit conversion operators are not supported (such as with Python.NET), you can use the OpcLabs.EasyOpc.UA.Engine.UAEndpointSelectionPolicy.UAEndpointSelectionPolicy Constructor(UAMessageSecurityModes) constructor instead.

The value of this parameter cannot be null (Nothing in Visual Basic).

The effective user identity information to evaluate.

The value of this parameter cannot be null (Nothing in Visual Basic).

Determines whether the endpoint descriptor demands preselection (discovery/GetEndpoints call) before establishing a connection.
Syntax
'Declaration
 
Public Function DemandsPreselection( _
   ByVal effectiveEndpointSelectionPolicy As UAEndpointSelectionPolicy, _
   ByVal effectiveUserIdentityInfo As UserIdentityInfo _
) As Boolean
'Usage
 
Dim instance As UAEndpointDescriptor
Dim effectiveEndpointSelectionPolicy As UAEndpointSelectionPolicy
Dim effectiveUserIdentityInfo As UserIdentityInfo
Dim value As Boolean
 
value = instance.DemandsPreselection(effectiveEndpointSelectionPolicy, effectiveUserIdentityInfo)

Parameters

effectiveEndpointSelectionPolicy
The effective endpoint selection policy to evaluate.

Because the OpcLabs.EasyOpc.UA.Engine.UAEndpointSelectionPolicy has an implicit conversion from OpcLabs.EasyOpc.UA.Engine.UAMessageSecurityModes, in languages that support implicit conversion operators (such as C# or VB.NET), you can simply use a OpcLabs.EasyOpc.UA.Engine.UAMessageSecurityModes in place of this parameter, and the corresponding OPC UA endpoint selection policy will be constructed automatically. When the implicit conversion operators are not supported (such as with Python.NET), you can use the OpcLabs.EasyOpc.UA.Engine.UAEndpointSelectionPolicy.UAEndpointSelectionPolicy Constructor(UAMessageSecurityModes) constructor instead.

The value of this parameter cannot be null (Nothing in Visual Basic).

effectiveUserIdentityInfo
The effective user identity information to evaluate.

The value of this parameter cannot be null (Nothing in Visual Basic).

Return Value

Returns true if preselection is required to obtain missing endpoint information (such as precise security settings or server certificate); otherwise, false.
Remarks

Preselection is demanded when the endpoint descriptor lacks information needed for connection, such as: precise message security modes, security policy URIs, server certificate (when required for encryption), or when multiple user token types are configured.

This method or property does not throw any exceptions, aside from execution exceptions such as System.Threading.ThreadAbortException or System.OutOfMemoryException.

Requirements

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

See Also