Contents Index Topic Contents
	Previous Topic: SHRegGetUSValue Next Topic: SHRegQueryInfoUSKey

SHRegOpenUSKey

LONG SHRegOpenUSKey(
    LPCTSTR  pszPath,
    REGSAM   samDesired,
    HUSKEY   hRelativeUSKey,
    PHUSKEY  phNewUSKey,
    BOOL     fIgnoreHKCU
    );

Opens a user-specific registry key.

• 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 get a generic description of the error.

pszPath

Handle to the currently open HKEY, or any of the following predefined handle values:

HKEY_CURRENT_USER

HKEY_CURRENT_USER_RELATIVE

HKEY_DYN_DATA (Windows 95 only)

HKEY_LOCAL_MACHINE

HKEY_LOCAL_MACHINE_RELATIVE

HKEY_PERFORMANCE_DATA (Windows NT only)

samDesired

Desired security access. For more information on security access, see REGSAM.

hRelativeUSKey

Data that indicates which type of HUSKEY to create.

phNewUSKey

Address of a HUSKEY value that receives the new key handle.

fIgnoreHKCU

Variable that indicates whether to ignore HKCU and bring HKLM up to date.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.