Echelon OpenLDV User Manual download pdf (Page 173)

OpenLDV Programmer’s Guide 165

E_HANDLE, LDVX_E_INVALID_DOWNLINK_KEY, or

LDVX_E_LOOKUP_FAILURE.

UpdateLookup Method

Applies to: xDriver Lookup Extension Component

This method is called by xDriver upon the completion of a change to a session

authentication key by xDriver. The lookup extension component must implement

an update to its database from this method, so that it stores the new values of the

current authentication key and the next authentication key from the SCO. These

fields can only be updated from the UpdateLookup method.

For more information about authentication key handling, see Authentication Key

Handling on page 111.

Syntax

C++ STDMETHOD(UpdateLookup)(ILdvxSCO * xSCO)

Visual Basic Sub UpdateLookup(ByVal xSCO As LdvxLib.ILdvxSCO)

Table 46. UpdateLookup Parameters

Parameter Description

xSCO Pointer to the Session Control Object that contains the new

authentication keys.

Returns

Standard xDriver LdvxResult (HRESULT) describing the result of the call.

UplinkLookup Method

Applies to: xDriver Lookup Extension Component

This method is called by xDriver when an uplink session is initiated. It is passed

a pointer to the xDriver Session Control Object (SCO) for the session. The SCO

contains the uplink lookup key passed in by the RNI.

It is the responsibility of the xDriver lookup extension to extract this lookup key

from the SCO, use it to access its xDriver database, and retrieve the

authentication and network parameters to be used by the rest of the xDriver

framework. Then, the lookup extension component must fill in the corresponding

fields of the SCO, including the Authentication Flag, Current Authentication

Key, Next Authentication Key, LNS Network Name, Downlink Key, and

Encryption Type. This information is then used by xDriver to complete the

session establishment.

1 2 ... 168 169 170 171 172 173 174 175 176 177 178 ... 193 194

No comments

Echelon OpenLDV User Manual Page 173