IERegSetValueEx function

Article
08/15/2017

Calls the standard RegSetValueEx from a higher-integrity user context. This function sets the data and type of a specified value under a registry key.

Syntax

HRESULT IERegSetValueEx(
  _In_       LPCWSTR lpSubKey,
  _In_       LPCWSTR lpValueName,
  _In_       DWORD   Reserved,
  _In_       DWORD   dwType,
  _In_ const BYTE    *lpData,
  _In_       DWORD   cbData
);

Parameters

lpSubKey [in]
The name of a subkey that this function opens or creates with medium integrity.
lpValueName [in]
The name of the value to be set. For more information, see Registry Element Size Limits.
Reserved [in]
This parameter is reserved and must be zero.
dwType [in]
The type of data pointed to by the lpData parameter. For a list of the possible types, see Registry Value Types.
lpData [in]
The data to be stored.
cbData [in]
The size of the information pointed to by the lpData parameter, in BYTE. If the data is of type REG_SZ, REG_EXPAND_SZ, or REG_MULTI_SZ, cbData must include the size of the terminating NULL character or characters.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Only supported in Windows Vista or later. If called from earlier versions of Microsoft Windows, this function returns E_NOTIMPL.

hKey is locked to HKCU - this interface cannot be used to elevate to admin privilege, high integrity, and write HKLM or HKCR settings.

The lpSubKey specified must be a subkey of the HKCU; it can be up to 32 levels deep in the registry tree. For more information on key names, see Structure of the Registry. If this parameter is NULL or an empty string, the function returns an error.

Requirements

Minimum supported client	Windows XP with SP2
Minimum supported server	Windows Server 2003
Product	Internet Explorer 8
Header	Iepmapi.h
Library	Iepmapi.lib
DLL	Ieframe.dll