Freigeben über


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.

Siehe auch

MAPI-Strukturen