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)

ビッグエンディアン形式で格納された 32 ビットの数値。

REG_EXPAND_SZ (2)

環境変数への展開されていない参照 ("%PATH%" など) を含む null で終わる Unicode 文字列。

REG_MULTI_SZ (6)

空の文字列 (\0) で終わる null で終わる文字列のシーケンス。

以下に例を示します。

String1\0String2\0String3\0LastString\0\0

最初の \0 は最初の文字列を終了し、最後の \0 の 2 番目の文字列は最後の文字列を終了し、最後の \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 を呼び出さないでください。

ClusterRegSetValue は、他のリソース DLL エントリポイント関数またはワーカースレッドから安全に呼び出すことができます。詳細については、「リソース DLL での回避する関数呼び出し」を参照してください。

要件


サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム	Windows
ヘッダー	clusapi.h
Library	ClusAPI.lib
[DLL]	ClusAPI.dll

次の方法で共有