CEEPQDV — query DLL variable

The CEEPQDV routine provides the virtual address of a particular exported variable of a specified DLL, which may then be used to reference the DLL's variable.

Note:

Usage by System Programmer C (SPC) is not supported.
Error diagnostics are available through the Language Environment® DLL Failure (CEEDLLF) control block chain.

Syntax

void CEEPQDV (dll_token, var_name, var_name_length, var_pointer, [fc])

TOKEN      *dll_token;
CHARn      *var_name;
INT4       *var_name_length;
POINTER    *var_pointer;
FEED_BACK  *fc;

CEEPQDV

Call this CWI interface as follows:

L     R15,CEECAACELV-CEECAA(,R12) 
L     R15,4028(,R15)
BALR  R14,R15

dll_token (input)

a 32-bit field that represents the DLL that is being queried for the named variable (var_name). This is the dll_token returned by CEEPLDE when the DLL was loaded.

var_name (input)

name of the requested variable exported from the DLL represented by the dll_token.

var_name_length (input)

length of the name of the requested variable.

var_pointer (output)

pointer to the requested variable, or 0.

fc (output/optional)

an optional 12-byte feedback code that indicates the results of the CWI. The following symbolic conditions may result from this service:

Condition
CEE000	Severity	0
	Msg_No	N/A
	Message	The service completed successfully.
CEE3FC	Severity	3
	Msg_No	3564
	Message	DLL constructors or destructors did not complete, so DLL dll_name cannot be used.
CEE3FH	Severity	2
	Msg_No	3569
	Message	The DLL function was not allowed because destructors are running for the DLL.
CEE3FK	Severity	0
	Msg_No	3572
	Message	The input dll_token was not available for use.
CEE3FN	Severity	0
	Msg_No	3575
	Message	DLL dll_name does not export any variables.
CEE3FO	Severity	0
	Msg_No	3576
	Message	External variable var_name was not found in DLL dll_name.
CEE3FQ	Severity	0
	Msg_No	3578
	Message	The external variable was not found in DLL dll_name.