Editing setRegPath - FilterMeisterWiki

When saving, enter the following:

       _  TTTTTT   ______   _____  _       _ 
      | | TT      (  ___ \ |_   _|( )  _  ( )
      | | TT      | (   ) )  | |  | | ( ) | |
  _   | | TTTT    | (__/ /   | |  | | | | | |
 | |__| | TT      |  __ (    | |  | (_/ \_) |
  \____/  TT      | (  \ \   \_/  `\___x___/'
          TTTTTT  | )___) )                  
                  |/ \___/

Visit Preferences to set your user name

= setRegPath =

== Syntax ==
{{int setRegPath(char * path[, args...])}}

== Arguments ==
:'''path'''
::A string specifying the path.
:'''args'''
::((printf)) style arguments with FM extensions.

== Return ==
:Returns ERROR_SUCCESS if the operation was successful, otherwise it returns one of the following integer error codes:
||ERROR_SUCCESS||(==0) no error||
||ERROR_FILE_NOT_FOUND||key or value name not found||
||ERROR_MORE_DATA||buffer wasn't big enough (e.g., getRegString, getRegData)||
||ERROR_NO_MORE_ITEMS||index >= # of values or subkeys (enumRegValue, enumRegSubKey)||
||ERROR_INVALID_FUNCTION||bad top-level key, etc||
||ERROR_INVALID_DATA||wrong data type or size (or size > 2048)||
||ERROR_BADDB||registry database is corrupt||
||ERROR_BADKEY||registry key is invalid||
||ERROR_CANTOPEN||registry key could not be opened||
||ERROR_CANTREAD||registry key could not be read||
||ERROR_CANTWRITE||registry key could not be written||
||ERROR_REGISTRY_CORRUPT||registry is corrupt||
||ERROR_REGISTRY_IO_FAILED||input/output to registry failed||
||ERROR_KEY_DELETED||Illegal operation attempted on a Registry key which has been marked for deletion.||
||ERROR_KEY_HAS_CHILDREN||cannot delete a key with subkeys (Windows NT)||

== Description ==
Sets the the current registry path.
By default, FM sets the registry path to "Software\\!O\\!C\\!t", which will expand to "Software\\<Organization>\\<Filter-category>\\<Filter-title>", as recommended by Microsoft.

== Example ==
<code>
// Sets the registry key and path back to the FM default values.
setRegRoot(HKEY_CURRENT_USER);
setRegPath("Software\\!O\\!C\\!t");
</code>

== See Also ==
((getRegPath)), ((setRegRoot))

== Comments ==
Everyone can add his comments about his experiences with this function here. Tips for using it are welcome, too.

Summary of change:
Add document to category: