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

SPropTagArray

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

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

フィールド

フィールドサイズx64x86説明
cValuesDWORD4+0+0aulPropTag 配列に含まれるプロパティタグの数。
aulPropTagDWORD4+4+4プロパティタグの可変長配列(先頭要素)。

公式ドキュメント

適用対象: Outlook 2013 | Outlook 2016

プロパティタグの配列を格納します。

プロパティ
ヘッダーファイル:
Mapidefs.h
関連マクロ:
CbNewSPropTagArray, CbSPropTagArray, SizedSPropTagArray
typedef struct _SPropTagArray
{
  ULONG cValues;
  ULONG aulPropTag[MAPI_DIM];
} SPropTagArray, FAR *LPSPropTagArray;

解説(Remarks)

プロパティタグは、次の 2 つの部分から構成される 32 ビットの符号なし整数です。

識別子は、特定の範囲内の数値です。MAPI は、プロパティの用途とその管理者を示すために識別子の範囲を定義しています。MAPI は、サポートする各プロパティタグの制約を Mapitags.h ヘッダーファイルで定義しています。

型は、プロパティの値の形式を示します。MAPI は、サポートする各プロパティ型の定数を Mapidefs.h ヘッダーファイルで定義しています。

プロパティタグとその構成要素の詳細については、次のいずれかのトピックを参照してください。

MAPI Property Tags

MAPI Property Identifier Overview

MAPI Property Type Overview

単値および多値のプロパティ型の完全な一覧については、付録の Property Identifiers and Types を参照してください。

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

各言語での定義

#include <windows.h>

// SPropTagArray  (x64 8 / x86 8 バイト)
typedef struct SPropTagArray {
    DWORD cValues;
    DWORD aulPropTag[1];
} SPropTagArray;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SPropTagArray
{
    public uint cValues;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public uint[] aulPropTag;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SPropTagArray
    Public cValues As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public aulPropTag() As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SPropTagArray(ctypes.Structure):
    _fields_ = [
        ("cValues", wintypes.DWORD),
        ("aulPropTag", wintypes.DWORD * 1),
    ]
#[repr(C)]
pub struct SPropTagArray {
    pub cValues: u32,
    pub aulPropTag: [u32; 1],
}
import "golang.org/x/sys/windows"

type SPropTagArray struct {
	cValues uint32
	aulPropTag [1]uint32
}
type
  SPropTagArray = record
    cValues: DWORD;
    aulPropTag: array[0..0] of DWORD;
  end;
const SPropTagArray = extern struct {
    cValues: u32,
    aulPropTag: [1]u32,
};
type
  SPropTagArray {.bycopy.} = object
    cValues: uint32
    aulPropTag: array[1, uint32]
struct SPropTagArray
{
    uint cValues;
    uint[1] aulPropTag;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SPropTagArray サイズ: 8 バイト(x64)
dim st, 2    ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; cValues : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; aulPropTag : DWORD (+4, 4byte)  varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SPropTagArray
    #field int cValues
    #field int aulPropTag 1
#endstruct

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