Contents Index Topic Contents
	Previous Topic: SHEnumValue Next Topic: SHSetValue

SHGetValue

DWORD SHGetValue(
    HKEY     hkey,
    LPCTSTR  pszSubKey,
    LPCTSTR  pszValue,
    LPDWORD  pdwType,
    LPVOID   pvData,
    LPDWORD  pcbData
    );

Retrieves a 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.

hkey

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

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_DYN_DATA (Windows 95 only)

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA (Windows NT only)

HKEY_USERS

pszSubKey

Address of a null-terminated string that specifies the name of the subkey from which to get the value.

pszValue

Address of the value.

pdwType

Type of value. For more information, see HKEY_TYPE.

pvData

Address of the destination data buffer.

pcbData

Size of the destination data buffer.

Note If your application must set/get a series of values in the same key, it is better to open the key once and set/get the values with the regular Microsoft® Win32® registry functions rather than use this function repeatedly.

---

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