Function DE Version 4.60

@NTRegistryGetValue

Misc System

Syntax

@NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3);
@NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3;TEXTRETURNTYPE4);

Beschreibung

Holt den Inhalt des Wert’s (Value) mit dem Namen TEXT TEXTVALUENAME2, unter dem KeyPfad TEXT TEXTKEYPATH1, und gibt diesen in RETVALUE3 zurück.

Der DataType von RETVALUE3 hängt vom Datentyp der Registry-Value ab.
Folgende Datentypen werden von der Registry unterstützt.
TEXT
TEXTLIST
DWORD (wird als FLOAT zurückgegeben)
BINÄR (wird als RT zurückgegeben)

Mit dem optionalen Parameter TEXT TEXTRETURNTYPE4 kann (bei BINÄR Registry-Einträgen) die Rückgabe als TD oder TDLIST interpretiert werden (vorausgesetzt die Anzahl der Bytes enspricht einem TD-Wert oder ergeben eine konsistente TDLIST).
TEXTRETURNTYPE4   Rückgabe-Datatype
"T"         TD
"TL"         TDLIST

ReturnWert:
Im Erfolgsfall TRUE, andernfalls @ERROR.

Beispiel: @NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3);

TEXTKEYPATH1:="HKEY_LOCAL_MACHINE\\SOFTWARE\\MyKey\\MyFirstSubKey";
TEXTVALUENAME2:="TestKeyValue";
Ret:=@NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3);
@LogReport(Ret);
@LogReport(RETVALUE3);

Holt den Wert (Value) mit dem Namen "TestKeyValue" unter dem KeyPfad "HKEY_LOCAL_MACHINE\\SOFTWARE\\MyKey\\MyFirstSubKey" und gibt dessen Inhalt in der Variable RETVALUE3 zurück.

Beispiel: @NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3;TEXTRETURNTYPE4);

TEXTKEYPATH1:="HKEY_LOCAL_MACHINE\\SOFTWARE\\MyKey\\MyFirstSubKey";
TEXTVALUENAME2:="TestKeyValue";
TEXTRETURNTYPE4:="T";
Ret:=@NTRegistryGetValue(TEXTKEYPATH1;TEXTVALUENAME2;RETVALUE3;TEXTRETURNTYPE4);
@LogReport(Ret);
@LogReport(RETVALUE3);

Holt den Wert (Value) mit dem Namen "TestKeyValue" unter dem KeyPfad "HKEY_LOCAL_MACHINE\\SOFTWARE\\MyKey\\MyFirstSubKey" und gibt dessen Inhalt in der Variable RETVALUE3 als TD zurück (sofern der Registry Datatype BINÄR ist und der Eintrag 8 Bytes lang ist).