ClusterRegSetValue 函数 (clusapi.h)

项目
08/22/2023

语法

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)

以 big-endian 格式存储的 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 ：

关闭
Offline
联机
打开
Terminate

可以从任何其他资源 DLL 入口点函数或工作线程安全地调用 ClusterRegSetValue。有关详细信息，请参阅在资源 DLL 中对避免的函数调用。

要求


最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台	Windows
标头	clusapi.h
Library	ClusAPI.lib
DLL	ClusAPI.dll

另请参阅

ClusterRegOpenKey

GetLastError

通过