SHRegOpenUSKeyA function

• 12/05/2018
• 2 minutes to read

Opens a registry subkey in a user-specific subtree (HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE).

Syntax

LSTATUS SHRegOpenUSKeyA(
  LPCSTR  pszPath,
  REGSAM  samDesired,
  HUSKEY  hRelativeUSKey,
  PHUSKEY phNewUSKey,
  BOOL    fIgnoreHKCU
);

Parameters

pszPath

Type: LPCTSTR

A pointer to a null-terminated string with the name of the subkey.

samDesired

Type: REGSAM

The desired security access. For more information on security access, see REGSAM.

hRelativeUSKey

Type: HUSKEY

The key to be used as a base for relative paths. If pszPath is a relative path, the key it specifies will be relative to hRelativeUSKey. If pszPath is an absolute path, set hRelativeUSKey to NULL.

phNewUSKey

Type: PHUSKEY

A pointer to the handle of the opened key.

fIgnoreHKCU

Type: BOOL

The variable that specifies which key to look under. When set to TRUE, SHRegOpenUSKey ignores HKEY_CURRENT_USER and returns a value from HKEY_LOCAL_MACHINE.

Return value

Type: LSTATUS

Returns ERROR_SUCCESS if successful, or a nonzero error code defined in Winerror.h otherwise. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to retrieve a generic description of the error.

Requirements