SPropValue
Aplica-se a: Outlook 2013 | Outlook 2016
Descreve uma propriedade MAPI.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
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
Marca de propriedade para a propriedade. As marcas de propriedade são inteiros sem sinal de 32 bits que consistem no identificador exclusivo da propriedade nos 16 bits de alta ordem e no tipo da propriedade nos 16 bits de baixa ordem.
dwAlignPad
Reservado para MAPI; não use.
Valor
União de valores de dados, o valor específico ditado pelo tipo de propriedade. A tabela a seguir lista cada tipo de propriedade, o membro do sindicato que deve ser usado e seu tipo de dados associado.
| Tipo de propriedade | Valor | Tipo de dados de Valor |
|---|---|---|
| PT_I2 ou PT_SHORT |
Eu |
short int |
| PT_I4 ou PT_LONG |
L |
LONGAS |
| - |
Ul |
ULONG |
| PT_R4 ou PT_FLOAT |
Flt |
flutuação |
| PT_R8 ou PT_DOUBLE |
Dbl |
double |
| PT_BOOLEAN |
B |
int curto sem sinal |
| PT_CURRENCY |
Cur |
CURRENCY |
| PT_APPTIME |
no |
double |
| PT_SYSTIME |
Ft |
FILETIME |
| PT_STRING8 |
lpszA |
LPSTR |
| PT_BINARY |
Bin |
BYTE [matriz] |
| PT_UNICODE |
lpszW |
LPWSTR |
| PT_CLSID |
lpguid |
LPGUID |
| PT_I8 ou 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 ou PT_OBJECT |
x |
LONGAS |
| PT_PTR ou PT_FILE_HANDLE |
Casulo |
VAZIO* |
Comentários
O membro ulPropTag é composto por duas partes:
Um identificador nos 16 bits de alta ordem.
Um tipo na ordem baixa de 16 bits.
O identificador é um valor numérico dentro de um intervalo específico. O MAPI define intervalos para identificadores para descrever para o que a propriedade é usada e para quem é responsável por mantê-la. O MAPI define restrições para cada uma das marcas de propriedade que ele dá suporte no arquivo de cabeçalho Mapitags.h.
O tipo indica o formato do valor da propriedade. O MAPI define constantes para cada um dos tipos de propriedade que ele dá suporte no arquivo de cabeçalho Mapidefs.h.
Para obter uma lista completa dos intervalos de propriedades válidos para identificadores e tipos de propriedade, consulte o apêndice Identificadores e Tipos de Propriedade .
O membro dwAlignPad é usado como preenchimento para garantir o alinhamento adequado em computadores que exigem alinhamento de 8 bytes para valores de 8 bytes. Os desenvolvedores que gravam código nesses computadores devem usar rotinas de alocação de memória que alocam as matrizes SPropValue em limites de 8 bytes.
O SPropValue::ul membro não tem nenhum tipo de propriedade MAPI correspondente, pois o VT_UI4 da OLE não é mapeado para MAPI. Para obter mais informações, consulte Visão geral do tipo de propriedade MAPI e Atualizando propriedades MAPI.
Quando o tipo de propriedade de um SPropValue indica PT_LONG, o membro ativo da união UPV é geralmente l, e o acesso ul constitui um comportamento indefinido de acordo com o padrão C.