Contents Index Topic Contents
	Previous Topic: SHRegEnumUSValue Next Topic: SHRegOpenUSKey

SHRegGetUSValue

LONG SHRegGetUSValue(
    LPCTSTR  pszSubKey,
    LPCTSTR  pszValue,
    LPDWORD  pdwType,
    LPVOID   pvData,
    LPDWORD  pcbData,
    BOOL     fIgnoreHKCU,
    LPVOID   pvDefaultData,
    DWORD    dwDefaultDataSize
    );

Retrieves a user-specific registry value.

• 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.

pszSubKey

Handle to the currently open subkey, or any of the following predefined, reserved 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)

pszValue

Address of the null-terminated string that specifies the name of the value.

pdwType

Type of data to be stored. This parameter must be the REG_SZ type. For more information, see HKEY_TYPE.

pvData

Address of a null-terminated string that contains the value to set for the specified key.

pcbData

Length, in bytes, of the string pointed to by the pvData parameter, not including the terminating null character.

fIgnoreHKCU

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

pvDefaultData

Address of the default data.

dwDefaultDataSize

Length, in bytes, of the default data.

---

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