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

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

See also

Reference

IERegisterWritableRegistryValue

IERegCreateKeyEx

IERegSetValueEx

IEUnregisterWritableRegistry