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

CLUSTER_READ_BATCH_COMMAND

構造体
サイズx64: 40 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
CommandCLUSTER_REG_COMMAND4+0+0

コマンドの結果状態です。次のいずれかの値になります。

CLUSREG_READ_VALUE (8)

結果構造体には、要求された値の内容が格納されています。dwOptions メンバーには、レジストリ値の型が設定されます。

CLUSREG_READ_ERROR (9)

値が存在しないか、読み取り中に別のエラーが発生しました。dwOptions メンバーには、実際のエラーの種類が格納されます。

dwOptionsDWORD4+4+4Command の結果に応じて、レジストリ値の型または読み取りエラーの種類が格納されます。
wzSubkeyNameLPWSTR8/4+8+8読み取りコマンドで要求されたキーの名前です。
wzValueNameLPWSTR8/4+16+12読み取りコマンドで要求された値の名前です。
lpDataBYTE*8/4+24+16値のデータへのポインターです。
cbDataDWORD4+32+20lpData の値データのバイト単位のサイズです。

公式ドキュメント

読み取りバッチ内の単一コマンドの結果を表します。

解説(Remarks)

CLUSTER_READ_BATCH_COMMAND 構造体内のポインターは、ClusterRegCloseReadBatchReply 関数によって読み取りバッチ結果のハンドルが閉じられるまで有効です。

読み取りコマンドのエラーは、それぞれ互いに独立しています。

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

各言語での定義

#include <windows.h>

// CLUSTER_READ_BATCH_COMMAND  (x64 40 / x86 24 バイト)
typedef struct CLUSTER_READ_BATCH_COMMAND {
    CLUSTER_REG_COMMAND Command;
    DWORD dwOptions;
    LPWSTR wzSubkeyName;
    LPWSTR wzValueName;
    BYTE* lpData;
    DWORD cbData;
} CLUSTER_READ_BATCH_COMMAND;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CLUSTER_READ_BATCH_COMMAND
{
    public int Command;
    public uint dwOptions;
    public IntPtr wzSubkeyName;
    public IntPtr wzValueName;
    public IntPtr lpData;
    public uint cbData;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CLUSTER_READ_BATCH_COMMAND
    Public Command As Integer
    Public dwOptions As UInteger
    Public wzSubkeyName As IntPtr
    Public wzValueName As IntPtr
    Public lpData As IntPtr
    Public cbData As UInteger
End Structure
import ctypes
from ctypes import wintypes

class CLUSTER_READ_BATCH_COMMAND(ctypes.Structure):
    _fields_ = [
        ("Command", ctypes.c_int),
        ("dwOptions", wintypes.DWORD),
        ("wzSubkeyName", ctypes.c_void_p),
        ("wzValueName", ctypes.c_void_p),
        ("lpData", ctypes.c_void_p),
        ("cbData", wintypes.DWORD),
    ]
#[repr(C)]
pub struct CLUSTER_READ_BATCH_COMMAND {
    pub Command: i32,
    pub dwOptions: u32,
    pub wzSubkeyName: *mut core::ffi::c_void,
    pub wzValueName: *mut core::ffi::c_void,
    pub lpData: *mut core::ffi::c_void,
    pub cbData: u32,
}
import "golang.org/x/sys/windows"

type CLUSTER_READ_BATCH_COMMAND struct {
	Command int32
	dwOptions uint32
	wzSubkeyName uintptr
	wzValueName uintptr
	lpData uintptr
	cbData uint32
}
type
  CLUSTER_READ_BATCH_COMMAND = record
    Command: Integer;
    dwOptions: DWORD;
    wzSubkeyName: Pointer;
    wzValueName: Pointer;
    lpData: Pointer;
    cbData: DWORD;
  end;
const CLUSTER_READ_BATCH_COMMAND = extern struct {
    Command: i32,
    dwOptions: u32,
    wzSubkeyName: ?*anyopaque,
    wzValueName: ?*anyopaque,
    lpData: ?*anyopaque,
    cbData: u32,
};
type
  CLUSTER_READ_BATCH_COMMAND {.bycopy.} = object
    Command: int32
    dwOptions: uint32
    wzSubkeyName: pointer
    wzValueName: pointer
    lpData: pointer
    cbData: uint32
struct CLUSTER_READ_BATCH_COMMAND
{
    int Command;
    uint dwOptions;
    void* wzSubkeyName;
    void* wzValueName;
    void* lpData;
    uint cbData;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CLUSTER_READ_BATCH_COMMAND サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; Command : CLUSTER_REG_COMMAND (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwOptions : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; wzSubkeyName : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; wzValueName : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; lpData : BYTE* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; cbData : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CLUSTER_READ_BATCH_COMMAND サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Command : CLUSTER_REG_COMMAND (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwOptions : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; wzSubkeyName : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; wzValueName : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpData : BYTE* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; cbData : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CLUSTER_READ_BATCH_COMMAND
    #field int Command
    #field int dwOptions
    #field intptr wzSubkeyName
    #field intptr wzValueName
    #field intptr lpData
    #field int cbData
#endstruct

stdim st, CLUSTER_READ_BATCH_COMMAND        ; NSTRUCT 変数を確保
st->Command = 100
mes "Command=" + st->Command