Compartir a través de


SPropValue

Hace referencia a: Outlook 2013 | Outlook 2016

Describe una propiedad MAPI.

Propiedad Valor
Archivo de encabezado:
Mapidefs.h
Macros relacionadas:
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

Etiqueta de propiedad de la propiedad. Las etiquetas de propiedad son enteros de 32 bits sin signo que constan del identificador único de la propiedad en los 16 bits de orden alto y el tipo de la propiedad en los 16 bits de orden bajo.

dwAlignPad

Reservado para MAPI; no usar.

Valor

Unión de valores de datos, el valor específico determinado por el tipo de propiedad. En la tabla siguiente se enumeran para cada tipo de propiedad, el miembro de la unión que se debe usar y su tipo de datos asociado.

Tipo de propiedad Valor Tipo de datos de Value
PT_I2 o PT_SHORT
i
short int
PT_I4 o PT_LONG
l
LARGO
-
Ul
ULONG
PT_R4 o PT_FLOAT
Flt
float
PT_R8 o PT_DOUBLE
Dbl
double
PT_BOOLEAN
B
unsigned short int
PT_CURRENCY
Cur
CURRENCY
PT_APPTIME
en
double
PT_SYSTIME
Pies
FILETIME
PT_STRING8
lpszA
LPSTR
PT_BINARY
Bin
BYTE [matriz]
PT_UNICODE
lpszW
LPWSTR
PT_CLSID
lpguid
LPGUID
PT_I8 o 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 o PT_OBJECT
x
LARGO
PT_PTR o PT_FILE_HANDLE
Lpv
VACÍO*

Comentarios

El miembro ulPropTag se compone de dos partes:

  • Identificador de 16 bits de orden alto.

  • Tipo de 16 bits de orden bajo.

El identificador es un valor numérico dentro de un intervalo determinado. MAPI define intervalos de identificadores para describir para qué se usa la propiedad y quién es responsable de mantenerla. MAPI define restricciones para cada una de las etiquetas de propiedad que admite en el archivo de encabezado Mapitags.h.

El tipo indica el formato del valor de la propiedad. MAPI define constantes para cada uno de los tipos de propiedad que admite en el archivo de encabezado Mapidefs.h.

Para obtener una lista completa de los intervalos de propiedades válidos para identificadores y tipos de propiedad, consulte el apéndice Identificadores de propiedad y tipos .

El miembro dwAlignPad se usa como relleno para asegurarse de una alineación adecuada en equipos que requieren alineación de 8 bytes para los valores de 8 bytes. Los desarrolladores que escriben código en estos equipos deben usar rutinas de asignación de memoria que asignen las matrices SPropValue en límites de 8 bytes.

El SPropValue::ul miembro no tiene ningún tipo de propiedad MAPI correspondiente, ya que el VT_UI4 de OLE no está asignado a MAPI. Para obtener más información, vea Información general sobre el tipo de propiedad MAPI y Actualización de propiedades MAPI. Cuando el tipo de propiedad de un SPropValue indica PT_LONG, el miembro activo de la unión UPV es generalmente ly el acceso ul constituye un comportamiento indefinido según el estándar de C.

Vea también

Estructuras MAPI