SPropValueSPropValue

適用されます: OutlookApplies to: Outlook

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. プロパティ タグは、プロパティの一意の識別子の上位 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
短い intshort int
PT_I4 または PT_LONG を (符号付き)PT_I4 or PT_LONG (signed)
ll
LONG
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
複列dbl
doubledouble
PT_BOOLEANPT_BOOLEAN
bb
符号なし短整数unsigned short int
PT_CURRENCYPT_CURRENCY
curcur
通貨CURRENCY
PT_APPTIMEPT_APPTIME
at
doubledouble
PT_SYSTIMEPT_SYSTIME
ftft
FILETIMEFILETIME
PT_STRING8PT_STRING8
lpszAlpszA
LPSTRLPSTR
PT_BINARYPT_BINARY
bin
バイト [配列]BYTE [array]
PT_UNICODEPT_UNICODE
lpszWlpszW
LPWSTRLPWSTR
PT_CLSIDPT_CLSID
lpguidlpguid
LPGUIDLPGUID
PT_I8 または PT_LONGLONGPT_I8 or PT_LONGLONG
lili
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
LONG
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.h ヘッダー ファイルでサポートされているプロパティ タグのそれぞれの制約を定義します。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