ホーム › System.AddressBook › SComparePropsRestriction

SComparePropsRestriction

構造体

サイズx64: 12 バイト / x86: 12 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
relop	DWORD	4	+0	+0	2つのプロパティ値を比較する関係演算子。RELOP_LT/LE/GT/GE/EQ/NEなどを指定する。
ulPropTag1	DWORD	4	+4	+4	比較元となる第1プロパティのプロパティタグ。比較対象の左辺を表す。
ulPropTag2	DWORD	4	+8	+8	比較先となる第2プロパティのプロパティタグ。比較対象の右辺を表す。

公式ドキュメント

適用対象: Outlook 2013 | Outlook 2016

リレーショナル演算子を使用して 2 つのプロパティを比較する、プロパティ比較制限について説明します。

プロパティ	値
ヘッダーファイル:	Mapidefs.h

typedef struct _SComparePropsRestriction
{
  ULONG relop;
  ULONG ulPropTag1;
  ULONG ulPropTag2;
} SComparePropsRestriction;

解説(Remarks)

比較の順序は (プロパティタグ 1) (リレーショナル演算子) (プロパティタグ 2) です。比較するプロパティは同じ型でなければなりません。異なる型のプロパティを比較しようとすると、この構造体がパラメーターとして渡される IMAPITable のメソッドから、MAPI またはサービスプロバイダーがエラー値 MAPI_E_TOO_COMPLEX を返します。

プロパティの一方または両方が存在しない場合、プロパティ比較値制限の結果は未定義です。クライアントがこのような制限に対して明確に定義された動作を必要とし、かつプロパティが存在するかどうかが不明な場合 (たとえば、テーブルの必須の列ではない場合) は、AND 制限を作成して、プロパティ比較制限と存在制限を結合します。存在制限の定義には SExistRestriction 構造体を、AND 制限の定義には SAndRestriction 構造体を使用します。

ulPropTag1 メンバーおよび ulPropTag2 メンバーで指定するプロパティは、サービスプロバイダーがサポートしている場合は複数値にできます。

SComparePropsRestriction 構造体および制限全般の詳細については、「About Restrictions」を参照してください。

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

各言語での定義

#include <windows.h>

// SComparePropsRestriction  (x64 12 / x86 12 バイト)
typedef struct SComparePropsRestriction {
    DWORD relop;
    DWORD ulPropTag1;
    DWORD ulPropTag2;
} SComparePropsRestriction;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SComparePropsRestriction
{
    public uint relop;
    public uint ulPropTag1;
    public uint ulPropTag2;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SComparePropsRestriction
    Public relop As UInteger
    Public ulPropTag1 As UInteger
    Public ulPropTag2 As UInteger
End Structure

import ctypes
from ctypes import wintypes

class SComparePropsRestriction(ctypes.Structure):
    _fields_ = [
        ("relop", wintypes.DWORD),
        ("ulPropTag1", wintypes.DWORD),
        ("ulPropTag2", wintypes.DWORD),
    ]

#[repr(C)]
pub struct SComparePropsRestriction {
    pub relop: u32,
    pub ulPropTag1: u32,
    pub ulPropTag2: u32,
}

import "golang.org/x/sys/windows"

type SComparePropsRestriction struct {
	relop uint32
	ulPropTag1 uint32
	ulPropTag2 uint32
}

type
  SComparePropsRestriction = record
    relop: DWORD;
    ulPropTag1: DWORD;
    ulPropTag2: DWORD;
  end;

const SComparePropsRestriction = extern struct {
    relop: u32,
    ulPropTag1: u32,
    ulPropTag2: u32,
};

type
  SComparePropsRestriction {.bycopy.} = object
    relop: uint32
    ulPropTag1: uint32
    ulPropTag2: uint32

struct SComparePropsRestriction
{
    uint relop;
    uint ulPropTag1;
    uint ulPropTag2;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SComparePropsRestriction サイズ: 12 バイト(x64)
dim st, 3    ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; relop : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulPropTag1 : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulPropTag2 : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SComparePropsRestriction
    #field int relop
    #field int ulPropTag1
    #field int ulPropTag2
#endstruct

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