IMAPISupport::ModifyStatusRow
Aplica-se a: Outlook 2013 | Outlook 2016
Modifica a tabela status adicionando uma nova linha ou modificando uma linha existente.
HRESULT ModifyStatusRow(
ULONG cValues,
LPSPropValue lpColumnVals,
ULONG ulFlags
);
Parâmetros
cValues
[in] A contagem de propriedades a serem incluídas na nova ou modificada linha de tabela status.
lpColumnVals
[in] Um ponteiro para uma matriz de valores de propriedade que descrevem as propriedades a serem incluídas como colunas na nova ou modificada linha de tabela status.
ulFlags
[in] Um bitmask de sinalizadores que controla como as informações que definem a linha de tabela status são processadas. O seguinte sinalizador pode ser definido:
STATUSROW_UPDATE
Orienta o MAPI a mesclar as propriedades incluídas na matriz apontada por lpColumnVals com uma linha de tabela status existente, em vez de em uma nova linha.
Valor de retorno
S_OK
A tabela status foi atualizada com êxito.
Comentários
O método IMAPISupport::ModifiStatusRow é implementado para todos os objetos de suporte do provedor de serviços. Os provedores de serviços chamam ModifiStatusRow no momento do logon para adicionar uma linha à tabela status e em outros momentos durante a sessão para atualizar a linha. ModifiStatusRow fornece mapi com as informações necessárias para criar a tabela status.
Notas para chamadores
Defina o sinalizador STATUSROW_UPDATE quando você chamar ModifiStatusRow para fazer alterações nas propriedades na linha de tabela status existente. Isso informa ao MAPI que apenas as colunas que estão sendo alteradas são passadas no parâmetro lpColumnVals .
Os clientes podem usar as informações na tabela status para acessar seu objeto status.
Para obter uma lista completa de colunas que você deve incluir na linha de tabela status, consulte Tabelas de Status.