Plug-in Reference — Inline Functions — Editor_RegQueryValue

# Editor_RegQueryValue

Retrieves the data for the specified value from the Registry or an INI file depending on the EmEditor settings. You can use this inline function or explicitly send the EE_REG_QUERY_VALUE message.

Editor_RegQueryValue( HWND hwnd, DWORD dwKey, LPCWSTR pszConfig, LPCWSTR pszValue, DWORD dwType, BYTE* lpData, DWORD* lpcbData, DWORD dwFlags );

## Parameters

hwnd

Specifies the window handle of the view or frame of EmEditor.

dwKey

Specifies one of the following values to specify a key. EEREG_CONFIG and EEREG_EMEDITORPLUGIN require the pszConfig parameter to specify the key.

EEREG_COMMON | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Common or eeCommon.ini\[Common]
EEREG_REGIST | HKEY_CURRENT_USER\Software\EmSoft\Regist or eeCommon.ini\[Regist]
EEREG_MACROS | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Macros or eeCommon.ini\[Macros]
EEREG_PLUGINS | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\PlugIns or eeCommon.ini\[PlugIns]
EEREG_RECENT_FILE_LIST | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Recent File List or eeCommon.ini\[Recent File List]
EEREG_RECENT_FOLDER_LIST | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Recent Folder List or eeCommon.ini\[Recent Folder List]
EEREG_RECENT_FONT_LIST | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Recent Font List or eeCommon.ini\[Recent Font List]
EEREG_RECENT_INSERT_LIST | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Recent Insert List or eeCommon.ini\[Recent Insert List]
EEREG_AUTOSAVE | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\AutoSave or eeCommon.ini\[AutoSave]
EEREG_LM_COMMON | HKEY_LOCAL_MACHINE\SOFTWARE\EmSoft\EmEditor v3\Common or eeLM.ini\[Common]
EEREG_LM_REGIST | HKEY_LOCAL_MACHINE\SOFTWARE\EmSoft\Regist or eeLM.ini\[Regist]
EEREG_CONFIG | HKEY_CURRENT_USER\Software\EmSoft\EmEditor v3\Config\(pszConfig) or eeConfig.ini\[(pszConfig)]
EEREG_EMEDITORPLUGIN | HKEY_CURRENT_USER\Software\EmSoft\EmEditorPlugIns\(pszConfig) or eePlugins.ini\[(pszConfig)]
EEREG_EMEDITORUSERS | HKEY_CURRENT_USER\Software\EmSoft\EmEditorUsers\(pszConfig) or eeUsers.ini\[(pszConfig)]

pszConfig

Specifies an additional string to specify the key when EEREG_CONFIG, EEREG_EMEDITORPLUGIN, or EEREG_EMEDITORUSERS is selected.

pszValue

Specifies the name of the value to be retrieved.

dwType

Specifies one of the following values to specify the type of data pointed to by the lpData parameter.

REG_BINARY | Binary data in any form.
REG_DWORD | A 32-bit number.
REG_SZ | A null-terminated Unicode string.

lpData

A pointer to a buffer that receives the value's data. This parameter can be NULL only if the data is of type REG_BINARY.

lpcbData

A pointer to a variable that specifies the size of the buffer pointed to by the lpData parameter, in bytes. When the function returns, this variable contains the size of the data copied to lpData.

dwFlags

This parameter is reserved and must be zero.

## Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a nonzero error code defined in Winerror.h.

## Version

Supported on EmEditor Version 7.00 or later.