ANSI C UA Server SDK  1.5.1.313
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Modules Pages
UaServerModule

Functions

OpcUa_StatusCode UaServer_SetUserAuthenticationType (UaServer *a_pUaServer, UaServer_UserAuthType a_type, UaServer_pfServer_AuthenticateSession a_pUserAuthFunction)
 Sets the authentication type used in ActivateSession. More...
 
OpcUa_StatusCode UaServer_SetUserAuthenticationTypeEx (UaServer *a_pUaServer, UaServer_UserAuthType a_type, UaServer_pfServer_AuthenticateSessionEx a_pUserAuthFunction)
 Sets the authentication type used in ActivateSession. More...
 
OpcUa_StatusCode UaServer_SetCallback_SessionCreated (UaServer *a_pUaServer, UaServer_pfServer_SessionCreated a_pCallbackFunction)
 Sets the SessionCreated callback function. More...
 
OpcUa_StatusCode UaServer_SetCallback_SessionActivated (UaServer *a_pUaServer, UaServer_pfServer_SessionActivated a_pCallbackFunction)
 Sets the SessionActivated callback function. More...
 
OpcUa_StatusCode UaServer_SetCallback_SessionClosed (UaServer *a_pUaServer, UaServer_pfServer_SessionClosed a_pCallbackFunction)
 Sets the SessionClosed callback function. More...
 
OpcUa_StatusCode UaServer_Initialize (UaServer *a_pUaServer)
 Initialize the UaServer object structure. More...
 
UaServer_Configuration * UaServer_GetConfiguration (UaServer *a_pUaServer)
 Returns the configuration struct of the server. More...
 
OpcUa_StatusCode UaServer_StartUp (UaServer *a_pUaServer)
 Start the UaServer to enable OPC UA connection establishment from clients. More...
 
OpcUa_StatusCode UaServer_DoCom ()
 The internal main 'event loop' which processes messages and triggers timers. More...
 
OpcUa_StatusCode UaServer_TimedDoCom (OpcUa_UInt32 a_uTimeout)
 The internal main 'event loop' which processes messages and triggers timers. More...
 
OpcUa_StatusCode UaServer_Shutdown (UaServer *a_pUaServer, OpcUa_UInt32 a_uSecondsTillShutdown, OpcUa_LocalizedText *a_pShutdownReason)
 Shut the server down in the given number of seconds. More...
 
OpcUa_Void UaServer_Clear (UaServer *a_pUaServer)
 Cleans up application and used resources. More...
 
OpcUa_StatusCode UaServer_Settings_GetConfigurationFromSettings (UaBase_Settings *pSettings, UaServer_Configuration *pServerConfiguration, const char *szHostname)
 Fill the server configuration object using the provided settings structure. More...
 

Detailed Description

Function Documentation

OpcUa_Void UaServer_Clear ( UaServer *  a_pUaServer)

Cleans up application and used resources.

Parameters
a_pUaServera pointer to the servers object.
OpcUa_StatusCode UaServer_DoCom ( )

The internal main 'event loop' which processes messages and triggers timers.

Returns
OpcUa_Good if no error occured. OpcUa_BadShutdown if UaServer_Shutdown was called and the shutdown time is reached.
UaServer_Configuration * UaServer_GetConfiguration ( UaServer *  a_pUaServer)

Returns the configuration struct of the server.

Parameters
[in]a_pUaServerThe server to use
Returns
A pointer to the configuration struct of the server.
OpcUa_StatusCode UaServer_Initialize ( UaServer *  a_pUaServer)

Initialize the UaServer object structure.

Parameters
[in]a_pUaServerA pointer to the UaServer object.
Returns
OPC UA Status code.
OpcUa_StatusCode UaServer_SetCallback_SessionActivated ( UaServer *  a_pUaServer,
UaServer_pfServer_SessionActivated  a_pCallbackFunction 
)

Sets the SessionActivated callback function.

This function was introduced in version 1.2.1.

Parameters
[in]a_pUaServerA pointer to the UaServer object.
[in]a_pCallbackFunctionThe function to call if a session was activated.
Returns
OpcUa_Good on success.
OpcUa_StatusCode UaServer_SetCallback_SessionClosed ( UaServer *  a_pUaServer,
UaServer_pfServer_SessionClosed  a_pCallbackFunction 
)

Sets the SessionClosed callback function.

This function was introduced in version 1.2.1.

Parameters
[in]a_pUaServerA pointer to the UaServer object.
[in]a_pCallbackFunctionThe function to call if a session was closed.
Returns
OpcUa_Good on success.
OpcUa_StatusCode UaServer_SetCallback_SessionCreated ( UaServer *  a_pUaServer,
UaServer_pfServer_SessionCreated  a_pCallbackFunction 
)

Sets the SessionCreated callback function.

This function was introduced in version 1.2.1.

Parameters
[in]a_pUaServerA pointer to the UaServer object.
[in]a_pCallbackFunctionThe function to call if a session was created.
Returns
OpcUa_Good on success.
OpcUa_StatusCode UaServer_Settings_GetConfigurationFromSettings ( UaBase_Settings pSettings,
UaServer_Configuration *  pServerConfiguration,
const char *  szHostname 
)

Fill the server configuration object using the provided settings structure.

The provided settings object is expected to contain settings described above.

Parameters
pSettingsThe settings to use.
pServerConfigurationThe server configuration to set.
szHostnameOptional: the string to replace [gethostname] placeholders with.
Returns
OpcUa_StatusCode
OpcUa_StatusCode UaServer_SetUserAuthenticationType ( UaServer *  a_pUaServer,
UaServer_UserAuthType  a_type,
UaServer_pfServer_AuthenticateSession  a_pUserAuthFunction 
)

Sets the authentication type used in ActivateSession.

Deprecated:
This function is deprecated as the passed UaServer_pfServer_AuthenticateSession callback does not support verifying the signature data of X509 tokens. It is recommended to use UaServer_SetUserAuthenticationTypeEx instead.
Parameters
[in]a_pUaServerA pointer to the UaServer object.
[in]a_typeThe authentication type to set.
[in]a_pUserAuthFunctionOptional: If a custom authentication module should be set, the function pointer to the authentication callback function must be set here and a_type to UserAuthType_User. If no custom authentication module is set, this parameter is ignored and can be OpcUa_Null.
Returns
OpcUa_Good on success.
OpcUa_StatusCode UaServer_SetUserAuthenticationTypeEx ( UaServer *  a_pUaServer,
UaServer_UserAuthType  a_type,
UaServer_pfServer_AuthenticateSessionEx  a_pUserAuthFunction 
)

Sets the authentication type used in ActivateSession.

Parameters
[in]a_pUaServerA pointer to the UaServer object.
[in]a_typeThe authentication type to set.
[in]a_pUserAuthFunctionOptional: If a custom authentication module should be set, the function pointer to the authentication callback function must be set here and a_type to UserAuthType_User. If no custom authentication module is set, this parameter is ignored and can be OpcUa_Null.
Returns
OpcUa_Good on success.
OpcUa_StatusCode UaServer_Shutdown ( UaServer *  a_pUaServer,
OpcUa_UInt32  a_uSecondsTillShutdown,
OpcUa_LocalizedText *  a_pShutdownReason 
)

Shut the server down in the given number of seconds.

After a_uSecondsTillShutdown have passed, UaServer_DoCom will return with status OpcUa_BadShutdown.

Parameters
a_pUaServerA pointer to the server object.
a_uSecondsTillShutdownThe number of seconds to wait until shutdown.
a_pShutdownReasonThe reason for shutdown.
Returns
OpcUa_Good if no error occured.
OpcUa_StatusCode UaServer_StartUp ( UaServer *  a_pUaServer)

Start the UaServer to enable OPC UA connection establishment from clients.

Parameters
a_pUaServera pointer to the UaServer object.
Returns
OPC UA Status code.
OpcUa_StatusCode UaServer_TimedDoCom ( OpcUa_UInt32  a_uTimeout)

The internal main 'event loop' which processes messages and triggers timers.

Parameters
a_uTimeoutThe timeout for the OpcUa_SocketManager_Loop call issued by this function.
Returns
OpcUa_Good if no error occured. OpcUa_BadShutdown if UaServer_Shutdown was called and the shutdown time is reached.