CRegKey::SetValue

项目
02/21/2013

调用此方法将数据存储在 m_hKey的字段指定值。此方法的早期版本不再支持和标记为 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
);

参数

pszValueName
对包含值的名称字符串的指针设置。如果具有该名称的值已不存在键，方法将其添加到密钥。如果 pszValueName 为NULL或为空字符串，""，则方法将类型和数据。未命名的一个或多个默认值。
dwType
指定指示数据类型的码位到由 pValue 参数。
pValue
对包含数据的缓冲区的指针将存储到指定的名称。
nBytes
在字节，信息指定大小，指向由 pValue 参数。如果数据是类型为REG_SZ、REG_EXPAND_SZ或REG_MULTI_SZ，nBytes 必须包括终止null字符范围。
hKeyParent
将打开键的句柄。
lpszKeyName
指定要在创建或打开的键的名称。此名称必须是 hKeyParent子级。
lpszValue
指定要存储的数据。此参数必须为非null。
lpszValueName
指定要设置的值字段中。如果具有该名称的值字段不存在于键，添加。
dwValue
指定要存储的数据。
bMulti
如果错误，指示字符串是类型为REG_SZ。如果为true，指示字符串是multistring类型REG_MULTI_SZ。
nValueLen
如果 bMulti 为true，nValueLen 是 lpszValue 字符串的长度在字符的。如果 bMulti 是错误的，值为-1表示方法将自动计算该长度。