EBSILON®Professional Online Dokumentation
EbsScript / EbsScript Funktionen / Registrierungsdatenbankfunktionen
In diesem Thema
    Registrierungsdatenbankfunktionen
    In diesem Thema

    Registrierungsdatenbankfunktionen


    Diese Funktionen werden für den Zugriff auf die System-Registrierungsdatenbank verwendet.

    Um einen Zugriff zu erhalten, ist zunächst mit regNewHandle ein Handle anzufordern. Mit diesem Handle können anschließend die übrigen Funktionen aufgerufen werden. Der Handle muss am Ende wieder mit regDeleteHandle freigegeben werden.

    Name

    Zweck

    Argumente

    Rückgabewert

    Beispiel

    regClose

    schließt den Zugriff auf einen Schlüssel in der Registrierungsdatenbank

    1: INTEGER: Handle

    BOOLEAN:
    true: o.k.
    false: Fehler

    regClose (reghandle)

    regCreateKey

    erzeugt einen neuen Schlüssel in der Registrierungsdatenbank und öffnet diesen zum Zugriff

    1: INTEGER: Handle

    2: BOOLEAN: Ordner, auf den zugegriffen werden soll:
    true: HKEY_CURRENT_USER
    false: HKEY_LOCAL_MACHINE
    (auf andere Ordner kann von EbsScript aus nicht zugegriffen werden)

    3: STRING: Pfad des gesuchten Schlüssels

    4: BOOLEAN
    true: nur Lesezugriff
    false: Lese-  und Schreibzugriff

    BOOLEAN:
    true: o.k.
    false: Fehler

    regCreateKey (reghandle, true, strRegPath, false);

    regDeleteHandle

    gibt den Handle auf die Registrierungsdatenbank wieder frei

    1: INTEGER: Handle

    -

    regDeleteHandle (reghandle);

    regNewHandle

    fordert einen Zugriffshandle auf die Registrierungsdatenbank an

    -

    INTEGER: Handle (im Fehlerfall 0)

    reghandle: = regNewHandle;

    regOpen

    öffnet den Zugriff auf einen Schlüssel in der Registrierungsdatenbank

    1: INTEGER: Handle

    2: BOOLEAN: Ordner, auf den zugegriffen werden soll:
    true: HKEY_CURRENT_USER
    false: HKEY_LOCAL_MACHINE

    3: STRING: Pfad des gesuchten Schlüssels

    4: BOOLEAN
    true: nur Lesezugriff
    false: Lese-  und Schreibzugriff

    BOOLEAN:
    true: o.k.
    false: Fehler

    regOpen (reghandle, true, strRegPath, false);

    regReadDWord

    liest einen Wert aus dem geöffneten Schlüssel der Registrierungsdatenbank

    1: INTEGER: Handle

    2: STRING: Name des Schlüssels

    3: INTEGER: Gelesener Wert

    BOOLEAN:
    true: o.k.
    false: Fehler

     

    regReadString

    liest einen String aus dem geöffneten Schlüssel der Registrierungsdatenbank

    1: INTEGER: Handle

    2: STRING: Name des Schlüssels

    3: STRING: Gelesener Wert

    BOOLEAN:
    true: o.k.
    false: Fehler

    regReadString (reghandle, regkeytim, oldstime);

    regWriteDWord

    schreibt einen Wert in den geöffneten Schlüssel der Registrierungsdatenbank

    1: INTEGER: Handle

    2: STRING: Name des Schlüssels

    3: INTEGER: Einzutragender Wert

    BOOLEAN:
    true: o.k.
    false: Fehler

     

    regWriteString

    schreibt einen String in den geöffneten Schlüssel der Registrierungsdatenbank

    1: INTEGER: Handle

    2: STRING: Name des Schlüssels

    3: STRING: Einzutragender Wert

    BOOLEAN:
    true: o.k.
    false: Fehler

    regWriteString (reghandle, regkeyval, newsvalue);