Win32 API 日本語リファレンス
ホームSystem.Wmi › SWbemRpnQueryToken

SWbemRpnQueryToken

構造体
サイズx64: 80 バイト / x86: 64 バイト

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

フィールド

フィールドサイズx64x86説明
m_uVersionDWORD4+0+0未使用です。常に 1 です。
m_uTokenTypeDWORD4+4+4

このインスタンスが表すトークンの種類です。

WMIQ_RPN_TOKEN_EXPRESSION (1)

このトークンは式です。たとえば J = 7 です。

WMIQ_RPN_TOKEN_AND (2)

このトークンは論理 AND です。

WMIQ_RPN_TOKEN_OR (3)

このトークンは論理 OR です。

WMIQ_RPN_TOKEN_NOT (4)

このトークンは論理 NOT です。

m_uSubexpressionShapeDWORD4+8+8

m_uTokenType メンバーが WMIQ_RPN_TOKEN_EXPRESSION の場合、m_uSubexpressionShape のビットマスク値は式の形状を指定します。

WMIQ_RPN_LEFT_PROPERTY_NAME (1 (0x1))

左側の引数はプロパティ名です。

WMIQ_RPN_RIGHT_PROPERTY_NAME (2 (0x2))

右側の引数はプロパティ名です。

WMIQ_RPN_CONST2 (4 (0x4))

2 つ目の定数を持ちます。"BETWEEN" 句で使用されます。

WMIQ_RPN_CONST (8 (0x8))

定数を持ちます。

WMIQ_RPN_RELOP (16 (0x10))

m_uOperator フィールドが 0 ではありません。

WMIQ_RPN_LEFT_FUNCTION (32 (0x20))

左側の引数は関数です。

WMIQ_RPN_RIGHT_FUNCTION (64 (0x40))

右側の引数は関数です。

m_uOperatorDWORD4+12+12

このフィールドには 0 または次のいずれかの値を指定できます。

WMIQ_RPN_OP_UNDEFINED (0 (0x0))

演算子が未定義または不明です。

WMIQ_RPN_OP_EQ (1 (0x1))

演算子は等価 (=) です。

WMIQ_RPN_OP_NE (2 (0x2))

演算子は非等価 (<>) です。

WMIQ_RPN_OP_GE (3 (0x3))

演算子は以上 (>=) です。

WMIQ_RPN_OP_LE (4 (0x4))

演算子は以下 (<=) です。

WMIQ_RPN_OP_LT (5 (0x5))

演算子は より小さい (<) です。

WMIQ_RPN_OP_GT (6 (0x6))

演算子は より大きい (>) です。

WMIQ_RPN_OP_LIKE (7 (0x7))

演算子は LIKE です。

WMIQ_RPN_OP_ISA (8 (0x8))

演算子は ISA です。

WMIQ_RPN_OP_ISNOTA (9 (0x9))

演算子は ISNOTA です。

WMIQ_RPN_OP_ISNULL (10 (0xA))

演算子は ISNULL です。

WMIQ_RPN_OP_ISNOTNULL (11 (0xB))

演算子は ISNOTNULL です。

m_pRightIdentSWbemQueryQualifiedName*8/4+16+16トークン内にプロパティ名が 2 つある場合、m_pRightIdent は右側のプロパティ名を識別するために使用されます。
m_pLeftIdentSWbemQueryQualifiedName*8/4+24+20トークン内にプロパティ名が 2 つある場合、m_pLeftIdent は左側のプロパティ名を識別するために使用されます。プロパティ名が 1 つのみの場合は、このメンバーに格納されます。
m_uConstApparentTypeDWORD4+32+24

定数の見かけ上のデータ型です。

VT_I4 (3 (0x3))

long データ型。

VT_R8 (5 (0x5))

倍精度浮動小数点データ型。

VT_BOOL (11 (0xB))

ブール データ型

VT_UI4 (19 (0x13))

符号なし long データ型。

VT_I8 (20 (0x14))

符号付き 64 ビット整数。

VT_UI8 (21 (0x15))

符号なし 64 ビット整数。

VT_LPWSTR (31 (0x1F))

LPCWSTR データ型。

m_ConstSWbemRpnConst8+40+321 つ目の定数の値です。詳細については、SWbemRpnConst を参照してください。
m_uConst2ApparentTypeDWORD4+48+40

2 つ目の定数の型です。m_uConst2ApparentType フィールドと m_uConst2 フィールドは、BETWEEN 句でのみ使用されます。

VT_I4 (3 (0x3))

long データ型。

VT_R8 (5 (0x5))

倍精度浮動小数点データ型。

VT_BOOL (11 (0xB))

ブール データ型。

VT_UI4 (19 (0x13))

符号なし long データ型。

VT_I8 (20 (0x14))

符号付き 64 ビット整数。

VT_UI8 (21 (0x15))

符号なし 64 ビット整数。

VT_LPWSTR (31 (0x1F))

LPCWSTR データ型。

m_Const2SWbemRpnConst8+56+482 つ目の定数の値です。m_uConst2ApparentType フィールドと m_uConst2 フィールドは、BETWEEN 句でのみ使用されます。詳細については、SWbemRpnConst を参照してください。
m_pszRightFuncLPWSTR8/4+64+56WHERE 句において演算子の右側にある関数を指定します。このトークン内で演算子の右側に関数が存在しない場合、このフィールドは NULL になります。
m_pszLeftFuncLPWSTR8/4+72+60WHERE 句において演算子の左側にある関数を指定します。このトークン内で演算子の左側に関数が存在しない場合、このフィールドは NULL になります。

公式ドキュメント

SWbemRpnQueryToken 構造体は、WMIQ_ANALYSIS_RPN_SEQUENCE 型のクエリ内のクエリトークンを表します。クエリトークンの例を次に示します: j > 4。

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

各言語での定義

#include <windows.h>

// SWbemRpnConst  (x64 8 / x86 8 バイト)
typedef struct SWbemRpnConst {
    LPWSTR m_pszStrVal;
    BOOL m_bBoolVal;
    INT m_lLongVal;
    DWORD m_uLongVal;
    DOUBLE m_dblVal;
    LONGLONG m_lVal64;
    LONGLONG m_uVal64;
} SWbemRpnConst;

// SWbemRpnQueryToken  (x64 80 / x86 64 バイト)
typedef struct SWbemRpnQueryToken {
    DWORD m_uVersion;
    DWORD m_uTokenType;
    DWORD m_uSubexpressionShape;
    DWORD m_uOperator;
    SWbemQueryQualifiedName* m_pRightIdent;
    SWbemQueryQualifiedName* m_pLeftIdent;
    DWORD m_uConstApparentType;
    SWbemRpnConst m_Const;
    DWORD m_uConst2ApparentType;
    SWbemRpnConst m_Const2;
    LPWSTR m_pszRightFunc;
    LPWSTR m_pszLeftFunc;
} SWbemRpnQueryToken;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SWbemRpnConst
{
    public IntPtr m_pszStrVal;
    [MarshalAs(UnmanagedType.Bool)] public bool m_bBoolVal;
    public int m_lLongVal;
    public uint m_uLongVal;
    public double m_dblVal;
    public long m_lVal64;
    public long m_uVal64;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SWbemRpnQueryToken
{
    public uint m_uVersion;
    public uint m_uTokenType;
    public uint m_uSubexpressionShape;
    public uint m_uOperator;
    public IntPtr m_pRightIdent;
    public IntPtr m_pLeftIdent;
    public uint m_uConstApparentType;
    public SWbemRpnConst m_Const;
    public uint m_uConst2ApparentType;
    public SWbemRpnConst m_Const2;
    public IntPtr m_pszRightFunc;
    public IntPtr m_pszLeftFunc;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SWbemRpnConst
    Public m_pszStrVal As IntPtr
    <MarshalAs(UnmanagedType.Bool)> Public m_bBoolVal As Boolean
    Public m_lLongVal As Integer
    Public m_uLongVal As UInteger
    Public m_dblVal As Double
    Public m_lVal64 As Long
    Public m_uVal64 As Long
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SWbemRpnQueryToken
    Public m_uVersion As UInteger
    Public m_uTokenType As UInteger
    Public m_uSubexpressionShape As UInteger
    Public m_uOperator As UInteger
    Public m_pRightIdent As IntPtr
    Public m_pLeftIdent As IntPtr
    Public m_uConstApparentType As UInteger
    Public m_Const As SWbemRpnConst
    Public m_uConst2ApparentType As UInteger
    Public m_Const2 As SWbemRpnConst
    Public m_pszRightFunc As IntPtr
    Public m_pszLeftFunc As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class SWbemRpnConst(ctypes.Structure):
    _fields_ = [
        ("m_pszStrVal", ctypes.c_void_p),
        ("m_bBoolVal", wintypes.BOOL),
        ("m_lLongVal", ctypes.c_int),
        ("m_uLongVal", wintypes.DWORD),
        ("m_dblVal", ctypes.c_double),
        ("m_lVal64", ctypes.c_longlong),
        ("m_uVal64", ctypes.c_longlong),
    ]

class SWbemRpnQueryToken(ctypes.Structure):
    _fields_ = [
        ("m_uVersion", wintypes.DWORD),
        ("m_uTokenType", wintypes.DWORD),
        ("m_uSubexpressionShape", wintypes.DWORD),
        ("m_uOperator", wintypes.DWORD),
        ("m_pRightIdent", ctypes.c_void_p),
        ("m_pLeftIdent", ctypes.c_void_p),
        ("m_uConstApparentType", wintypes.DWORD),
        ("m_Const", SWbemRpnConst),
        ("m_uConst2ApparentType", wintypes.DWORD),
        ("m_Const2", SWbemRpnConst),
        ("m_pszRightFunc", ctypes.c_void_p),
        ("m_pszLeftFunc", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct SWbemRpnConst {
    pub m_pszStrVal: *mut core::ffi::c_void,
    pub m_bBoolVal: i32,
    pub m_lLongVal: i32,
    pub m_uLongVal: u32,
    pub m_dblVal: f64,
    pub m_lVal64: i64,
    pub m_uVal64: i64,
}

#[repr(C)]
pub struct SWbemRpnQueryToken {
    pub m_uVersion: u32,
    pub m_uTokenType: u32,
    pub m_uSubexpressionShape: u32,
    pub m_uOperator: u32,
    pub m_pRightIdent: *mut core::ffi::c_void,
    pub m_pLeftIdent: *mut core::ffi::c_void,
    pub m_uConstApparentType: u32,
    pub m_Const: SWbemRpnConst,
    pub m_uConst2ApparentType: u32,
    pub m_Const2: SWbemRpnConst,
    pub m_pszRightFunc: *mut core::ffi::c_void,
    pub m_pszLeftFunc: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type SWbemRpnConst struct {
	m_pszStrVal uintptr
	m_bBoolVal int32
	m_lLongVal int32
	m_uLongVal uint32
	m_dblVal float64
	m_lVal64 int64
	m_uVal64 int64
}

type SWbemRpnQueryToken struct {
	m_uVersion uint32
	m_uTokenType uint32
	m_uSubexpressionShape uint32
	m_uOperator uint32
	m_pRightIdent uintptr
	m_pLeftIdent uintptr
	m_uConstApparentType uint32
	m_Const SWbemRpnConst
	m_uConst2ApparentType uint32
	m_Const2 SWbemRpnConst
	m_pszRightFunc uintptr
	m_pszLeftFunc uintptr
}
type
  SWbemRpnConst = record
    m_pszStrVal: Pointer;
    m_bBoolVal: BOOL;
    m_lLongVal: Integer;
    m_uLongVal: DWORD;
    m_dblVal: Double;
    m_lVal64: Int64;
    m_uVal64: Int64;
  end;

  SWbemRpnQueryToken = record
    m_uVersion: DWORD;
    m_uTokenType: DWORD;
    m_uSubexpressionShape: DWORD;
    m_uOperator: DWORD;
    m_pRightIdent: Pointer;
    m_pLeftIdent: Pointer;
    m_uConstApparentType: DWORD;
    m_Const: SWbemRpnConst;
    m_uConst2ApparentType: DWORD;
    m_Const2: SWbemRpnConst;
    m_pszRightFunc: Pointer;
    m_pszLeftFunc: Pointer;
  end;
const SWbemRpnConst = extern struct {
    m_pszStrVal: ?*anyopaque,
    m_bBoolVal: i32,
    m_lLongVal: i32,
    m_uLongVal: u32,
    m_dblVal: f64,
    m_lVal64: i64,
    m_uVal64: i64,
};

const SWbemRpnQueryToken = extern struct {
    m_uVersion: u32,
    m_uTokenType: u32,
    m_uSubexpressionShape: u32,
    m_uOperator: u32,
    m_pRightIdent: ?*anyopaque,
    m_pLeftIdent: ?*anyopaque,
    m_uConstApparentType: u32,
    m_Const: SWbemRpnConst,
    m_uConst2ApparentType: u32,
    m_Const2: SWbemRpnConst,
    m_pszRightFunc: ?*anyopaque,
    m_pszLeftFunc: ?*anyopaque,
};
type
  SWbemRpnConst {.bycopy.} = object
    m_pszStrVal: pointer
    m_bBoolVal: int32
    m_lLongVal: int32
    m_uLongVal: uint32
    m_dblVal: float64
    m_lVal64: int64
    m_uVal64: int64

  SWbemRpnQueryToken {.bycopy.} = object
    m_uVersion: uint32
    m_uTokenType: uint32
    m_uSubexpressionShape: uint32
    m_uOperator: uint32
    m_pRightIdent: pointer
    m_pLeftIdent: pointer
    m_uConstApparentType: uint32
    m_Const: SWbemRpnConst
    m_uConst2ApparentType: uint32
    m_Const2: SWbemRpnConst
    m_pszRightFunc: pointer
    m_pszLeftFunc: pointer
struct SWbemRpnConst
{
    void* m_pszStrVal;
    int m_bBoolVal;
    int m_lLongVal;
    uint m_uLongVal;
    double m_dblVal;
    long m_lVal64;
    long m_uVal64;
}

struct SWbemRpnQueryToken
{
    uint m_uVersion;
    uint m_uTokenType;
    uint m_uSubexpressionShape;
    uint m_uOperator;
    void* m_pRightIdent;
    void* m_pLeftIdent;
    uint m_uConstApparentType;
    SWbemRpnConst m_Const;
    uint m_uConst2ApparentType;
    SWbemRpnConst m_Const2;
    void* m_pszRightFunc;
    void* m_pszLeftFunc;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SWbemRpnQueryToken サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; m_uVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; m_uTokenType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; m_uSubexpressionShape : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; m_uOperator : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; m_pRightIdent : SWbemQueryQualifiedName* (+16, 4byte)  varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; m_pLeftIdent : SWbemQueryQualifiedName* (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; m_uConstApparentType : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; m_Const : SWbemRpnConst (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; m_uConst2ApparentType : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; m_Const2 : SWbemRpnConst (+48, 8byte)  varptr(st)+48 を基点に操作(8byte:入れ子/配列)
; m_pszRightFunc : LPWSTR (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; m_pszLeftFunc : LPWSTR (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SWbemRpnQueryToken サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; m_uVersion : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; m_uTokenType : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; m_uSubexpressionShape : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; m_uOperator : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; m_pRightIdent : SWbemQueryQualifiedName* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; m_pLeftIdent : SWbemQueryQualifiedName* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; m_uConstApparentType : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; m_Const : SWbemRpnConst (+40, 8byte)  varptr(st)+40 を基点に操作(8byte:入れ子/配列)
; m_uConst2ApparentType : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; m_Const2 : SWbemRpnConst (+56, 8byte)  varptr(st)+56 を基点に操作(8byte:入れ子/配列)
; m_pszRightFunc : LPWSTR (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; m_pszLeftFunc : LPWSTR (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SWbemRpnQueryToken
    #field int m_uVersion
    #field int m_uTokenType
    #field int m_uSubexpressionShape
    #field int m_uOperator
    #field intptr m_pRightIdent
    #field intptr m_pLeftIdent
    #field int m_uConstApparentType
    #field byte m_Const 8
    #field int m_uConst2ApparentType
    #field byte m_Const2 8
    #field intptr m_pszRightFunc
    #field intptr m_pszLeftFunc
#endstruct

stdim st, SWbemRpnQueryToken        ; NSTRUCT 変数を確保
st->m_uVersion = 100
mes "m_uVersion=" + st->m_uVersion
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。