ITnef::SetProps
Aplica-se a: Outlook 2013 | Outlook 2016
Define o valor de uma ou mais propriedades para uma mensagem encapsulada ou anexo sem modificar a mensagem original ou o anexo.
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que controla como os valores de propriedade são definidos. O seguinte sinalizador pode ser definido:
TNEF_PROP_CONTAINED
Codifica apenas propriedades da mensagem ou anexo especificados pelo parâmetro ulElemID .
ulElemID
[in] A propriedade PR_ATTACH_NUM de um anexo (PidTagAttachNumber), que contém um número que identifica exclusivamente o anexo em sua mensagem pai.
cValues
[in] O número de valores de propriedade na estrutura SPropValue apontada pelo parâmetro lpProps .
lpProps
[in] Um ponteiro para uma estrutura SPropValue que contém os valores de propriedade das propriedades a serem definidas.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Provedores de transporte, provedores de armazenamento de mensagens e gateways chamam o método ITnef::SetProps para definir propriedades a serem incluídas no encapsulamento de uma mensagem ou um anexo sem modificar a mensagem original ou o anexo. Todas as propriedades definidas com essa chamada substituem as propriedades existentes na mensagem encapsulada.
O SetProps só tem suporte para objetos TNEF abertos com o sinalizador TNEF_ENCODE para a função OpenTnefStream ou OpenTnefStreamEx . Qualquer número de propriedades pode ser definida com essa chamada.
Observação
Nenhuma codificação TNEF real para SetProps acontece até que o método ITnef::Finish seja chamado. Essa funcionalidade significa que os ponteiros passados para SetProps devem permanecer válidos até que a chamada para Concluir seja feita. Nesse ponto, todos os objetos e dados passados para chamadas SetProps podem ser liberados ou liberados.