Contents Index Topic Contents
	Previous Topic: SHGetValue Next Topic: SHOpenRegStream

SHSetValue

DWORD SHSetValue(
    HKEY     hkey,
    LPCTSTR  pszSubKey,
    LPCTSTR  pszValue,
    DWORD    dwType,
    LPCVOID  pvData,
    DWORD    cbData
    );

Sets the value of a 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.

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 with which a value is associated. This can be NULL or a pointer to an empty string. In this case, the value will be added to the key identified by the hKey parameter.

pszValue

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

dwType

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.

cbData

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

---

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