EBSILON®Professional Online Documentation
EbsScript / EbsScript Functions / Registry Database Functions
In This Topic
    Registry Database Functions
    In This Topic

    Registry Database Functions


    These functions are used for accessing the System Registry database.

    To get an access, a new handle must first be requested with the help of regNewHandle. The remaining functions can then be called by means of this handle. At the end, the handle must be released again with the help of regDeleteHandle.

    Name

    Purpose

    Arguments

    Return value

    Example

    regClose

    closes the access to a key in the registry database

    1: INTEGER: Handle

    BOOLEAN:
    true: OK
    false: Error

    regClose (reghandle)

    regCreateKey

    generates a new key in the registry database and opens this for access

    1: INTEGER: Handle

    2: BOOLEAN: Folder to be accessed:
    true: HKEY_CURRENT_USER
    false: HKEY_LOCAL_MACHINE
    (other folders cannot be accessed from EbsScript)

    3: STRING: Path of the searched key

    4: BOOLEAN
    true: read-only access
    false: read and write access

    BOOLEAN:
    true: OK
    false: Error

    regCreateKey (reghandle, true, strRegPath, false);

    regDeleteHandle

    releases the handle on the registry database

    1: INTEGER: Handle

    BOOLEAN:
    true: OK
    false: Error

    regDeleteHandle (reghandle);

    regNewHandle

    requests for an access handle to the registry database

    -

    INTEGER: Handle (in case of error 0)

    reghandle: = regNewHandle;

    regOpen

    opens the access to a key in the registry database

    1: INTEGER: Handle

    2: BOOLEAN: Folder to be accessed:
    true: HKEY_CURRENT_USER
    false: HKEY_LOCAL_MACHINE

    3: STRING: Path of the searched key

    4: BOOLEAN
    true: read-only access
    false: read and write access

    BOOLEAN:
    true: OK
    false: Error

    regOpen (reghandle, true, strRegPath, false)

    regReadDWord

    reads a value from the open key of the registry database

    1: INTEGER: Handle

    2: STRING: Name of the key

    3: INTEGER: read value

    BOOLEAN:
    true: OK
    false: Error

     

    regReadString

    reads a string from the open key of the registry database

    1: INTEGER: Handle

    2: STRING: Name of the key

    3: STRING: read value

    BOOLEAN:
    true: OK
    false: Error

    regReadString (reghandle, regkeytim, oldstime

    regWriteDWord

    writes a value to the open key of the registry database

    1: INTEGER: Handle

    2: STRING: Name of the key

    3: INTEGER: value to be entered

    BOOLEAN:
    true: OK
    false: Error

     

    regWriteString

    writes a string in the open key of the registry database

    1: INTEGER: Handle

    2: STRING: Name of the key

    3: STRING: value to be entered

    BOOLEAN:
    true: OK
    false: Error

    regWriteString (reghandle, regkeyval, newsvalue);