Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PCLUSAPI_CLUSTER_REG_SET_VALUE

PCLUSAPI_CLUSTER_REG_SET_VALUE

コールバック

シグネチャ

DWORD PCLUSAPI_CLUSTER_REG_SET_VALUE(
    HKEY hKey,
    LPWSTR lpszValueName,
    DWORD dwType,
    BYTE* lpData,
    DWORD cbData
);

パラメーター

フィールド型説明
hKeyHKEYクラスターデータベースキーのハンドルです。
lpszValueNameLPWSTR設定する値の名前を格納した、null で終わる Unicode 文字列へのポインターです。この名前の値がリソースにまだ存在しない場合、 ClusterRegSetValue はその値をリソースに追加します。
dwTypeDWORD

値のデータとして格納する情報の種類です。このパラメーターには次のいずれかの値を指定できます。詳細については、レジストリ値の型を参照してください。

REG_BINARY (3)

任意の形式のバイナリデータです。

REG_DWORD (4)

32 ビットの数値です。

REG_DWORD_BIG_ENDIAN (5)

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

REG_EXPAND_SZ (2)

環境変数への未展開の参照 (たとえば "%PATH%") を含む、null で終わる Unicode 文字列です。

REG_MULTI_SZ (6)

null で終わる文字列の並びで、空の文字列 () で終端されます。

次に例を示します。

String1String2String3LastString

最初の は最初の文字列を終端し、最後から 2 番目の は最後の文字列を終端し、 末尾の は並び全体を終端します。この末尾の終端文字も文字列の長さに含める必要があることに注意してください。

REG_NONE (0)

定義された値の型がありません。

REG_QWORD (11)

64 ビットの数値です。

REG_SZ (1)

null で終わる Unicode 文字列です。

lpDataBYTE*lpszValueName が指す名前とともに格納するデータへのポインターです。
cbDataDWORDlpbData パラメーターが指すデータのバイト数です。データの型が REG_SZ、REG_EXPAND_SZ、または REG_MULTI_SZ の場合、cbData には null 終端文字のサイズを含める必要があります。

公式ドキュメント

クラスターデータベース のキーに値を設定します。

戻り値

処理が成功した場合、この関数は ERROR_SUCCESS を返します。

処理が失敗した場合、この関数は システムエラーコードを返します。

解説(Remarks)

ClusterRegSetValue は、次のリソース DLL のエントリポイント関数から呼び出さないでください。

ClusterRegSetValue は、それ以外のリソース DLL のエントリポイント関数やワーカースレッドからであれば安全に呼び出せます。詳細については、 リソース DLL で避けるべき関数呼び出しを参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)