SPropValue
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt eine MAPI-Eigenschaft.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
| Verwandte Makros: |
CHANGE_PROP_TYPE, MVI_PROP, PROP_ID, PROP_TAG, PROP_TYPE |
typedef struct _SPropValue
{
ULONG ulPropTag;
ULONG dwAlignPad;
union _PV Value;
} SPropValue, FAR *LPSPropValue;
Members
ulPropTag
Eigenschaftstag für die Eigenschaft. Eigenschaftstags sind 32-Bit-Ganzzahlen ohne Vorzeichen, die aus dem eindeutigen Bezeichner der Eigenschaft in den hohen 16 Bits und dem Typ der Eigenschaft in den niedrigen 16 Bits bestehen.
dwAlignPad
Reserviert für MAPI; nicht verwenden.
Wert
Union von Datenwerten, der spezifische Wert, der vom Eigenschaftentyp vorgegeben wird. In der folgenden Tabelle sind die einzelnen Eigenschaftentypen, der Member der Union, der verwendet werden soll, und der zugehörige Datentyp aufgeführt.
| Eigenschaftentyp | Wert | Datentyp des Werts |
|---|---|---|
| PT_I2 oder PT_SHORT |
Ich |
short int |
| PT_I4 oder PT_LONG |
l |
LANGE |
| - |
Ul |
ULONG |
| PT_R4 oder PT_FLOAT |
Flt |
Gleitkommazahl |
| PT_R8 oder PT_DOUBLE |
Dz |
double |
| PT_BOOLEAN |
B |
unsigned short int |
| PT_CURRENCY |
Cur |
CURRENCY |
| PT_APPTIME |
unter |
double |
| PT_SYSTIME |
Ft |
FILETIME |
| PT_STRING8 |
lpszA |
LPSTR |
| PT_BINARY |
bin |
BYTE [Array] |
| PT_UNICODE |
lpszW |
LPWSTR |
| PT_CLSID |
lpguid |
LPGUID |
| PT_I8 oder PT_LONGLONG |
Li |
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 oder PT_OBJECT |
x |
LANGE |
| PT_PTR oder PT_FILE_HANDLE |
lpv |
LEERE* |
Hinweise
Das ulPropTag-Element besteht aus zwei Teilen:
Ein Bezeichner in der hohen Reihenfolge von 16 Bits.
Ein Typ in der niedrigen Reihenfolge von 16 Bits.
Der Bezeichner ist ein numerischer Wert innerhalb eines bestimmten Bereichs. MAPI definiert Bereiche für Bezeichner, um zu beschreiben, wofür die Eigenschaft verwendet wird und wer für die Verwaltung verantwortlich ist. MAPI definiert Einschränkungen für die einzelnen Eigenschaftentags, die in der Headerdatei "Mapitags.h" unterstützt werden.
Der Typ gibt das Format für den Wert der Eigenschaft an. MAPI definiert Konstanten für jeden der Eigenschaftentypen, die in der Headerdatei Mapidefs.h unterstützt werden.
Eine vollständige Liste der gültigen Eigenschaftsbereiche für Bezeichner und Eigenschaftentypen finden Sie im Anhang Eigenschaftenbezeichner und Typen .
Der dwAlignPad-Member wird als Auffüllung verwendet, um eine ordnungsgemäße Ausrichtung auf Computern sicherzustellen, die eine Acht-Byte-Ausrichtung für 8-Byte-Werte erfordern. Entwickler, die Code auf solchen Computern schreiben, sollten Speicherbelegungsroutinen verwenden, die die SPropValue-Arrays an 8-Byte-Grenzen zuordnen.
Der SPropValue::ul Member weist keinen entsprechenden MAPI-Eigenschaftentyp auf, da die VT_UI4 von OLE nicht mapI zugeordnet ist. Weitere Informationen finden Sie unter Übersicht über MAPI-Eigenschaftentypen und Aktualisieren von MAPI-Eigenschaften.
Wenn der Eigenschaftentyp eines SPropValue-Objekts PT_LONG angibt, ist der aktive Member der UPV-Union im Allgemeinen l, und der Zugriff ul stellt ein nicht definiertes Verhalten gemäß dem C-Standard dar.