AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X |
|
| X |
| X |
|
| X |
Purpose
Updates a registry string value in the Web registry.
Format
@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)
@DTWR_UPDATEENTRY(registry, registryVariable, newData)
Parameters
Table 210. DTWR_UPDATEENTRY Parameters
Data Type | Parameter | Use | Description |
---|---|---|---|
string | registry | IN | The name of the registry with the entry to update. |
string | registryVariable | IN | The value of the registryVariable string portion of the registry entry to update. |
string | newData | IN | The new value for the registryData string portion of the registry entry to update. |
string | index | IN | The value of the index portion of the registryVariable string in an indexed entry to update. This is an optional parameter. If specified, the indexed entry is updated. |
Return Codes
Table 211. DTWR_UPDATEENTRY Return Codes
Return Code | Explanation |
---|---|
-1001 | The server could not process a Net.Data request to allocate memory. |
1001 | An input parameter contained a NULL value. |
1002 | An input parameter contained a string value which consisted of the null-terminating character. |
1003 | An incorrect number of parameters were passed on a function call. |
1005 | A parameter passed on a function call, required to be a string variable, was of a different variable type. |
1007 | A parameter contains a value which is not valid. |
3003 | A Web registry built-in function could not add an entry to the specified registry because the specified entry already exists. |
3004 | A Web registry built-in function could not remove or retrieve an entry from the specified registry because the specified entry does not exist. |
3005 | A Web registry built-in function could not use the specified registry because it cannot be found. |
3007 | A Web registry built-in function could not complete the specified operation because the requestor does not have the proper authority to the specified registry. |
Usage Notes
The registry entry name corresponding to the value cannot be changed.
Examples
Example 1:
@DTWR_UPDATEENTRY("Myregistry", "Jones", "http://advantis.com/~Jones/personal")
Example 2:
@DTWR_UPDATEENTRY("URLLIST", "SMITH", "http://www.ibm.com/software/personal", "WORK_URL")