SPropValueSPropValue

適用対象: Outlook 2013 | Outlook 2016Applies to: Outlook 2013 | Outlook 2016

MAPI プロパティについて説明します。Describes a MAPI property.

ヘッダー ファイル:Header file:
mapidefs.hMapidefs.h
関連するマクロ:Related macros:
CHANGE_PROP_TYPEMVI_PROPPROP_IDPROP_TAGPROP_TYPECHANGE_PROP_TYPE, MVI_PROP, PROP_ID, PROP_TAG, PROP_TYPE
typedef struct _SPropValue
{
  ULONG ulPropTag;
  ULONG dwAlignPad;
  union _PV Value;
} SPropValue, FAR *LPSPropValue;

メンバーMembers

ulPropTagulPropTag

プロパティのプロパティタグ。Property tag for the property. property タグは、上位16ビットのプロパティの一意の識別子と、下位16ビットのプロパティの型で構成される、32ビットの符号なし整数です。Property tags are 32-bit unsigned integers consisting of the property's unique identifier in the high-order 16 bits and the property's type in the low-order 16 bits.

dwAlignPaddwAlignPad

MAPI 用に予約済み。を使用しないでください。Reserved for MAPI; do not use.

Value

データ値の和集合。プロパティの型によって指定される特定の値。Union of data values, the specific value dictated by the property type. 次の表に、使用する必要がある結合のメンバーと、関連付けられたデータ型について、各プロパティの種類の一覧を示します。The following table lists for each property type, the member of the union that should be used and its associated data type.

プロパティの種類Property type Value 値のデータ型Data type of Value
PT_I2 または PT_SHORTPT_I2 or PT_SHORT
ii
short intshort int
PT_I4 または PT_LONG (署名済み)PT_I4 or PT_LONG (signed)
ll
LONGLONG
PT_I4 または PT_LONG (署名なし)PT_I4 or PT_LONG (unsigned)
ulul
ULONGULONG
PT_R4 または PT_FLOATPT_R4 or PT_FLOAT
fltflt
浮動小数点数float
PT_R8 または PT_DOUBLEPT_R8 or PT_DOUBLE
clickdbl
doubledouble
PT_BOOLEANPT_BOOLEAN
bb
符号なし short intunsigned short int
PT_CURRENCYPT_CURRENCY
.curcur
CURRENCYCURRENCY
PT_APPTIMEPT_APPTIME
下部at
doubledouble
PT_SYSTIMEPT_SYSTIME
cmft
FILETIMEFILETIME
PT_STRING8PT_STRING8
lpszAlpszA
LPSTRLPSTR
PT_BINARYPT_BINARY
在庫bin
BYTE [配列]BYTE [array]
PT_UNICODEPT_UNICODE
lpszwlpszW
LPWSTRLPWSTR
PT_CLSIDPT_CLSID
lpguidlpguid
lpguidLPGUID
PT_I8 または PT_LONGLONGPT_I8 or PT_LONGLONG
&li
LARGE_INTEGERLARGE_INTEGER
PT_MV_I2PT_MV_I2
mviMVi
SShortArraySShortArray
PT_MV_LONGPT_MV_LONG
mviMVI
SLongArraySLongArray
PT_MV_R4PT_MV_R4
MVfltMVflt
SRealArraySRealArray
PT_MV_DOUBLEPT_MV_DOUBLE
MVdblMVdbl
SDoubleArraySDoubleArray
PT_MV_CURRENCYPT_MV_CURRENCY
MVcurMVcur
SCurrencyArraySCurrencyArray
PT_MV_APPTIMEPT_MV_APPTIME
mvatMVat
SAppTimeArraySAppTimeArray
PT_MV_SYSTIMEPT_MV_SYSTIME
MVftMVft
SDateTimeArraySDateTimeArray
PT_MV_BINARYPT_MV_BINARY
mvbinMVbin
SBinaryArraySBinaryArray
PT_MV_STRING8PT_MV_STRING8
MVszAMVszA
SLPSTRArraySLPSTRArray
PT_MV_UNICODEPT_MV_UNICODE
MVszWMVszW
SWStringArraySWStringArray
PT_MV_CLSIDPT_MV_CLSID
MVguidMVguid
SGuidArraySGuidArray
PT_MV_I8PT_MV_I8
MVliMVli
SLargeIntegerArraySLargeIntegerArray
PT_ERRORPT_ERROR
errerr
SCODESCODE
PT_NULL または PT_OBJECTPT_NULL or PT_OBJECT
xx
LONGLONG
PT_PTRPT_PTR
lpvlpv
VOID*VOID *

注釈Remarks

ulPropTagメンバーは、次の2つの部分で構成されます。The ulPropTag member is made up of two parts:

  • 上位16ビットの識別子。An identifier in the high-order 16 bits.

  • ローオーダー16ビットの型。A type in the low-order 16 bits.

識別子は、特定の範囲内の数値です。The identifier is a numeric value within a particular range. MAPI は、識別子の範囲を定義して、プロパティがどのように使用され、保持する責任者を示します。MAPI defines ranges for identifiers to describe what the property is used for and who is responsible for maintaining it. MAPI は、Mapitags ヘッダーファイルでサポートされている各プロパティタグに対する制約を定義します。MAPI defines constraints for each of the property tags that it supports in the Mapitags.h header file.

この型は、プロパティの値の形式を示します。The type indicates the format for the property's value. MAPI は、mapidefs.h ヘッダーファイルでサポートされている各プロパティの種類に対して定数を定義します。MAPI defines constants for each of the property types that it supports in the Mapidefs.h header file.

識別子およびプロパティの種類の有効なプロパティ範囲の完全な一覧については、「付録」の「プロパティの識別子と種類」を参照してください。For a complete list of the valid property ranges for identifiers and property types, see the Property Identifiers and Types appendix.

dwAlignPadメンバーは、8バイト値の8バイト配置を必要とするコンピューターで適切に配置されるように、パディングとして使用されます。The dwAlignPad member is used as padding to make sure proper alignment on computers that require 8-byte alignment for 8-byte values. このようなコンピューターでコードを記述する開発者は、8バイト境界にspropvalue配列を割り当てるメモリ割り当てルーチンを使用する必要があります。Developers who write code on such computers should use memory allocation routines that allocate the SPropValue arrays on 8-byte boundaries.

詳細については、「 mapi プロパティの種類の概要」および「 mapi プロパティの更新」を参照してください。For more information, see MAPI Property Type Overview and Updating MAPI Properties.

関連項目See also

MAPI の構造MAPI Structures