Share via


IERegSetValueEx function

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

See also

Reference

IERegisterWritableRegistryKey

IERegisterWritableRegistryValue

IERegCreateKeyEx

IEUnregisterWritableRegistry