ClusterRegSetValue 函式 (clusapi.h)
設定 叢集資料庫 索引鍵的值。
語法
DWORD ClusterRegSetValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[in] DWORD dwType,
[in] const BYTE *lpData,
[in] DWORD cbData
);
參數
[in] hKey
叢集資料庫金鑰的控制碼。
[in] lpszValueName
Null 終止 Unicode 字串的指標，其中包含要設定的值名稱。 如果資源中還沒有具有此名稱的值，ClusterRegSetValue會將它新增至資源。
[in] dwType
要儲存為值資料的資訊類型。 此參數可以是下列其中一個值。 如需詳細資訊，請參閱 登錄實數值型別。
REG_BINARY (3)
任何形式的二進位資料，
REG_DWORD (4)
32 位數位。
REG_DWORD_BIG_ENDIAN (5)
以大端格式儲存的 32 位數位。
REG_EXPAND_SZ (2)
Null 終止的 Unicode 字串，其中包含環境變數的未展開參考 (，例如 「%PATH%」) 。
REG_MULTI_SZ (6)
以 Null 結尾的字串序列，由空字串終止， (\0) 。
以下是一個範例：
String1\0String2\0String3\0LastString\0\0
第一個 \0 會終止第一個字串，第二個到最後一個 \0 會終止最後一個字串，最後一個 \0 會終止序列。 請注意，最終結束字元必須納入字串的長度。
REG_NONE (0)
沒有定義的實值型別。
REG_QWORD (11)
64 位數位。
REG_SZ (1)
以 Null 結尾的 Unicode 字串。
[in] lpData
要以 lpszValueName所指向名稱儲存之資料的指標。
[in] cbData
lpbData參數所指向之資料中的位元組計數。 如果資料的類型為 REG_SZ， REG_EXPAND_SZ 或 REG_MULTI_SZ， cbData 必須包含 null 終止字元的大小。
傳回值
如果作業成功，函式會傳回 ERROR_SUCCESS。
如果作業失敗，函式會傳回 系統錯誤碼。
備註
請勿從下列資源 DLL 進入點函式呼叫 ClusterRegSetValue ：
您可以從任何其他資源 DLL 進入點函式或背景工作執行緒安全地呼叫ClusterRegSetValue。 如需詳細資訊，請參閱 在資源 DLL 中避免的函式呼叫。
規格需求
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |