Editing enumRegValue - FilterMeisterWiki

When saving, enter the following:

 #####     _       ______   #    #   ___   
 #    #   | |     (  __  \  ##   #  (  _`\ 
 #    #   | |     | (  \  ) # #  #  | ( (_)
 #####    | |     | |   ) | #  # #  | |___ 
 #        | |____ | |   | | #   ##  | (_, )
 #        |______|| |   ) | #    #  (____/'
 #                | (__/  ) #    #         
                  (______/

Visit Preferences to set your user name

= enumRegValue =
== Syntax ==
:{{int enumRegValue(int index, lpsz szValueName, int maxValueNameLen, int *piType, int *pcbData)}}
== Arguments ==
:'''index'''
::is the zero-based index for the next value name to be retrieved
:'''szValueName'''
::is a character string buffer to receive the value name
:'''maxValueNameLen'''
::is the size of the szValueName buffer in bytes (including room for the terminating null character)
:'''piType'''
::is the address of an int variable which will receive a code indicating the type of data associated with this value (REG_DWORD for 32-bit integer data, REG_SZ for character string data, REG_BINARY for byte sequence data)
:'''pcbData'''
::is the address of an int variable which will receive the size in bytes of the data associated with this value
== 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 ==
:Enumerates the names of all values stored under the current key.
== Example ==
<code>
// fetches installed fonts from the registry and loads them into a combobox
// (modified example, original by Alex Hunter)

%fml

ctl[0]: combobox,"Style 1\nStyle 2\nStyle 3",pos=(*,10),size=(99,50),val=0,Action=PREVIEW
ctl[1]: pushbutton, "Populate Font List", size=(80,15), pos=(*,35)

int iRetVal;
int iDataType;
int iDataLen;

OnCtl(n):{

if (n==1 && e== FME_CLICKED){

setCtlText(0, ""); //clear the ComboBox control

getRegPath(str9, 256);   //save current registry path
Info("path=%s",str9);

setRegRoot(HKEY_LOCAL_MACHINE);
setRegPath("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Fonts");

getRegPath(str0, 256);   //save current registry path
Info("path=%s",str0);

for (i=0, iRetVal=ERROR_SUCCESS; iRetVal == ERROR_SUCCESS; i++) {

iRetVal = enumRegValue(i, str0, 256,&iDataType, &iDataLen);

if (i<21){Info("i=%i, iRetVal=%i,value=%s",i,iRetVal,str0);}

if (iRetVal == ERROR_SUCCESS) {
            setCtlItemText(0,i,str0);
	}
}
    setRegPath(str9);    //restore registry path to original value
}

return false;
}
</code>
== Also see ==
:((getRegRoot)), ((setRegRoot)), ((getRegPath)), ((setRegPath))

Summary of change:
Add document to category: