SPropValue
適用対象: Outlook 2013 | Outlook 2016
MAPI プロパティについて説明します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapidefs.h |
| 関連するマクロ: |
CHANGE_PROP_TYPE、 MVI_PROP、 PROP_ID、 PROP_TAG、 PROP_TYPE |
typedef struct _SPropValue
{
ULONG ulPropTag;
ULONG dwAlignPad;
union _PV Value;
} SPropValue, FAR *LPSPropValue;
メンバー
ulPropTag
プロパティのプロパティ タグ。 プロパティ タグは、上位 16 ビットのプロパティの一意識別子と、下位 16 ビットのプロパティの型で構成される 32 ビット符号なし整数です。
dwAlignPad
MAPI 用に予約済み。は使用しないでください。
値
データ値の和集合。プロパティ型によって指定される特定の値。 次の表は、各プロパティ型、使用する共用体のメンバー、およびその関連するデータ型の一覧です。
| プロパティの種類 | 値 | Value のデータ型 |
|---|---|---|
| PT_I2またはPT_SHORT |
i |
short int |
| PT_I4またはPT_LONG |
l |
長い |
| - |
Ul |
Ulong |
| PT_R4またはPT_FLOAT |
Flt |
浮動小数点数 |
| PT_R8またはPT_DOUBLE |
Dbl |
double |
| PT_BOOLEAN |
B |
unsigned short int |
| PT_CURRENCY |
電流 |
CURRENCY |
| PT_APPTIME |
で |
double |
| PT_SYSTIME |
フィート |
FILETIME |
| PT_STRING8 |
lpszA |
Lpstr |
| PT_BINARY |
箱 |
BYTE [array] |
| PT_UNICODE |
lpszW |
Lpwstr |
| PT_CLSID |
lpguid |
LPGUID |
| PT_I8またはPT_LONGLONG |
李 |
LARGE_INTEGER |
| PT_MV_I2 |
MVi |
SShortArray |
| PT_MV_LONG |
MVI |
SLongArray |
| PT_MV_R4 |
MVflt |
SRealArray |
| PT_MV_DOUBLE |
MVdbl |
SDoubleArray |
| PT_MV_CURRENCY |
MVcur |
SCurrencyArray |
| PT_MV_APPTIME |
MVat |
SAppTimeArray |
| PT_MV_SYSTIME |
MVft |
SDateTimeArray |
| PT_MV_BINARY |
MVbin |
SBinaryArray |
| PT_MV_STRING8 |
MVszA |
SLPSTRArray |
| PT_MV_UNICODE |
MVszW |
SWStringArray |
| PT_MV_CLSID |
MVguid |
SGuidArray |
| PT_MV_I8 |
MVli |
SLargeIntegerArray |
| PT_ERROR |
err |
SCODE |
| PT_NULLまたはPT_OBJECT |
x |
長い |
| PT_PTRまたはPT_FILE_HANDLE |
lpv |
無効* |
注釈
ulPropTag メンバーは、次の 2 つの部分で構成されます。
上位 16 ビットの識別子。
下位 16 ビットの型。
識別子は、特定の範囲内の数値です。 MAPI は、プロパティが使用される内容と、そのプロパティの管理を担当するユーザーを記述する識別子の範囲を定義します。 MAPI は、Mapitags.h ヘッダー ファイルでサポートされる各プロパティ タグの制約を定義します。
型は、プロパティの値の形式を示します。 MAPI は、Mapidefs.h ヘッダー ファイルでサポートされているプロパティの種類ごとに定数を定義します。
識別子とプロパティ型の有効なプロパティ範囲の完全な一覧については、 プロパティ識別子と型 の付録を参照してください。
dwAlignPad メンバーは、8 バイト値に対して 8 バイトのアラインメントを必要とするコンピューターで適切な配置を行うために、パディングとして使用されます。 このようなコンピューターでコードを記述する開発者は、8 バイト境界で SPropValue 配列を割り当てるメモリ割り当てルーチンを使用する必要があります。
OLE の SPropValue::ul VT_UI4が MAPI にマップされていないため、メンバーには対応する MAPI プロパティの種類がありません。 詳細については、「 MAPI プロパティの種類の概要 」と「 MAPI プロパティの更新」を参照してください。
SPropValue のプロパティ型がPT_LONGを示す場合、UPV 共用体のアクティブなメンバーは一般に lであり、アクセス ul は C 標準に従って未定義の動作を構成します。