Please enable JavaScript to view this site.

A-Shell Reference

xcall MIAMEX, MX_REGISTRY, REGOP_READ, hkey, name, type, value, status

Read is used to read a single value from the Registry.

Parameters

hkey, name

must be set as in opcode 3 (Set)

type  (Num)  [out]

is ignored on input, and is updated by the call to indicate the data type of the value returned (see table of data types under Set).

value (String, Raw, or B,4 depending on the type of the data)  [out]

returns the data. Note that the application is expected to either know the type of data, in which case it can supply an appropriate form of value, or it can use the overlay technique and then extract the data based on the returned type field. Also note that for string data, value must be large enough to include the trailing null. For example, you might map value as:

MAP1 VALUEX,X,512

MAP1 VALUE$,S,,512,@VALUEX

MAP1 VALUE,B,4,@VALUEX

 

status  (F6)  [out]

0 for success, else error code.