IERegisterWritableRegistryKey function

Calls the standard RegCreateKeyEx from a higher-integrity user context. Registers a key during installation so that low integrity processes can write into this location during run time.

Syntax

C++


HRESULT IERegisterWritableRegistryKey(
       GUID    guid,
  _In_ LPCWSTR lpSubkey,
       BOOL    fSubkeyAllowed
);

Parameters

guid: Defaults to NULL. This attribute can be set to a string representing the registry key within HKEY_CURRENT_USER.
lpSubkey [in]: The name of a subkey that this function opens or creates with medium integrity.
fSubkeyAllowed: Set to TRUE to allow a subkey; FALSE otherwise.

Return value

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

Remarks

The registry path is restricted to HKEY_CURRENT_USER only. This interface cannot be used to elevate to admin privilege, high integrity, or write HKEY_LOCAL_MACHINE.

The specified lpSubkey must be a subkey of HKEY_CURRENT_USER; it can be up to 32 levels deep in the registry tree. 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