SRowSet
Aplica-se a: Outlook 2013 | Outlook 2016
Contém uma matriz de estruturas SRow . Cada estrutura SRow descreve uma linha de uma tabela.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
| Macros relacionadas: |
CbNewSRowSet, CbSRowSet, SizedSRowSet |
typedef struct _SRowSet
{
ULONG cRows;
SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;
Members
Corvos
Contagem de estruturas SRow no membro aRow .
aRow
Matriz de estruturas SRow . Há uma estrutura para cada linha na tabela.
Comentários
Uma estrutura SRowSet é usada para descrever várias linhas de dados de uma tabela. As estruturas SRowSet são usadas nos métodos de interface IAddrBook, ITableData e IMAPITable, além das seguintes funções:
As estruturas SRowSet são definidas da mesma forma que as estruturas ADRLIST para permitir que as linhas de uma tabela do destinatário e as entradas em uma lista de endereços sejam tratadas da mesma forma. As estruturas SRowSet e ADRLIST podem ser passadas para métodos como IMessage::ModifiRecipients e IAddrBook::Address.
Além disso, as regras para alocação de memória para estruturas SRowSet são as mesmas das estruturas ADRLIST . Para resumir, cada estrutura SPropValue na matriz apontada pelo membro lpProps de cada linha no conjunto de linhas deve ser alocada separadamente usando MAPIAllocateBuffer. Cada estrutura de valor de propriedade também deve ser desalocada usando MAPIFreeBuffer antes da desalocação de sua estrutura SRowSet para que os ponteiros para as estruturas de SPropValue alocadas não sejam perdidos. Em seguida, a memória alocada de uma linha pode ser preservada e reutilizado fora do contexto da estrutura SRowSet .
Para obter mais informações sobre como a memória para estruturas SRowSet deve ser alocada, consulte Gerenciando memória para estruturas ADRLIST e SRowSet.