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

See also

Reference

IERegisterWritableRegistryKey

IERegisterWritableRegistryValue

IERegCreateKeyEx

IEUnregisterWritableRegistry

Build date: 11/27/2012