LBR$Get_Module

LBR ››
Parent Previous Next

LBR$Get_Module

Get module from library


LBR$Get_Module retrieves a module from a library.


Format:

LBR$Get_Module context {routine} {data} {key}


Returns:

Returns a condition code.


Arguments:

context

The address of a 64-bit context value returned by LBR_INI_CONTROL that indicates the library to access.


routine

The address of a callback routine. This routine is called to return the requested data. Two parameters are passed to the routine. The first is the value passed in the data argument (0 if not passed). The second is the address of a TSRB structure that points to the module data. This data is only valid until the callback routine returns.


data

The address of a 64-bit integer value to be passed to the callback routine.


key

The address of a TSRB structure that points to the name of the module to be returned. If the key is 0 or name is null, an error is returned.


Description

Returns the specified module data.


Condition Codes Returned:

Code

Meaning

LBR_ILLCTL

Specified context is not valid.

LBR_LIBNOTOPN

Specified library is not open.

LBR_NOTFOUND

Specified module is not found in the library.

SS_NORMAL

Successful completion.