FB_RegSetValue

 VAR_INPUT

VAR_INPUT
    sNetId      :T_AmsNetId;   
    sSubKey     :T_MaxString; 
    sValName    :T_MaxString;
    eValType    :E_RegValueType;
    cbData      :UDINT;
    pData       :UDINT; 
    bExecute    :BOOL;
    tTimeOut    :TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

sNetId: Here a string containing the network address of the TwinCAT Computer can be given, whose system registration should be written. The string can also be empty for the local computer.

sSubKey: String with SubKey  name.

sValName: String with value name.

eValType: Data type format of  of the registration data to be written e.g. REG_DWORD or REG_SZ. 

cbData: Number of value data bytes to be written (at string variables inclusive the terminal zero).

pD ata:  Address of a data buffer/PLC variables, which contains the value data. The address can be ascertained from the ADR-Operator. The programmer himself is responsible for the dimension of the data buffer:.it must be possible to take cbData data bytes from the buffer.

bExecute: The command is executed with a positive edge at the input

tTimeOut: Maximum time allowed for the execution of the ADS command.

VAR_OUTPUT

VAR_OUTPUT
    bBusy       :BOOL;
    bError      :BOOL;
    nErrId      :UDINT;
    cbWrite     :UDINT;
END_VAR

bBusy: When the function block is activated this output is set. It remains set until and acknowledgement is received.

bError: If an ADS error should occur during the execution of the command, then this output is set, after the bBusy output has been reset. 

nErrId: When the bError output is set, this variable supplies the ADS error or the command-specific error code (table). 

cbWrite: Number of successfully written value data bytes.

Example:

A Subkey SOFTWARE\MyCompany\MyProject' witt the key name 'LogFileName' , the type REG_SZ and the value 'c:\MyProject\Log'' should be created and set in the branch with the predefined handle HKEY_LOCAL_MACHINE.

PROGRAM MAIN
VAR
    fbRegSetValue   : FB_RegSetValue;
    bBusy           : BOOL;
    bError          : BOOL;
    nErrId          : UDINT;
    cbWrite         : UDINT;
    bWrite          : BOOL;
    sNewValue               : STRING := 'c:\MyProject\Log';
END_VAR

Requirements