Share via


CRegKey::SetValue

Call this method to store data in the specified value field of m_hKey. Earlier versions of this method are no longer supported and are marked as ATL_DEPRECATED.

LONG SetValue( 
   LPCTSTR pszValueName, 
   DWORD dwType, 
   const void* pValue, 
   ULONG nBytes  
) throw( ); 
static LONG WINAPI SetValue( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   LPCTSTR lpszValue, 
   LPCTSTR lpszValueName = NULL); 
ATL_DEPRECATED LONG SetValue( 
   DWORD dwValue, 
   LPCTSTR lpszValueName  
); 
ATL_DEPRECATED LONG SetValue( 
   LPCTSTR lpszValue, 
   LPCTSTR lpszValueName = NULL, 
   bool bMulti = false, 
   int nValueLen = -1 
);

Parameters

  • pszValueName
    Pointer to a string containing the name of the value to set. If a value with this name is not already present in the key, the method adds it to the key. If pszValueName is NULL or an empty string, "", the method sets the type and data for the key's unnamed or default value.

  • dwType
    Specifies a code indicating the type of data pointed to by the pValue parameter.

  • pValue
    Pointer to a buffer containing the data to be stored with the specified value name.

  • nBytes
    Specifies the size, in bytes, of the information pointed to by the pValue parameter. If the data is of type REG_SZ, REG_EXPAND_SZ, or REG_MULTI_SZ, nBytes must include the size of the terminating null character.

  • hKeyParent
    The handle of an open key.

  • lpszKeyName
    Specifies the name of a key to be created or opened. This name must be a subkey of hKeyParent.

  • lpszValue
    Specifies the data to be stored. This parameter must be non-NULL.

  • lpszValueName
    Specifies the value field to be set. If a value field with this name does not already exist in the key, it is added.

  • dwValue
    Specifies the data to be stored.

  • bMulti
    If false, indicates the string is of type REG_SZ. If true, indicates the string is a multistring of type REG_MULTI_SZ.

  • nValueLen
    If bMulti is true, nValueLen is the length of the lpszValue string in characters. If bMulti is false, a value of -1 indicates that the method will calculate the length automatically.

Return Value

If successful, returns ERROR_SUCCESS; otherwise, a nonzero error code defined in WINERROR.H.

Remarks

The two original versions of SetValue are marked as ATL_DEPRECATED and should no longer be used. The compiler will issue a warning if these forms are used.

The third method calls RegSetValueEx.

Requirements

Header: atlbase.h

See Also

Reference

CRegKey Class

CRegKey::SetKeyValue

CRegKey::QueryValue

Registry Value Types