CRegKey::SetValue

發行項
02/28/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
out 包含值的名稱字串的指標陣列。如果使用此名稱的值已經不存在於機碼中，此方法將其加入至金鑰。如果 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
如果為 false，則表示為字串型別 REG_SZ。如果為 true，表示資料是 multistring 型別 REG_MULTI_SZ。
nValueLen
如果 bMulti 為 true 時， nValueLen 是 lpszValue 字串的長度 (以字元為單位)。如果 bMulti 為 false 時，值-1 表示方法會自動計算長度。