ITnef::OpenTaggedBody
Aplica-se a: Outlook 2013 | Outlook 2016
Abre uma interface de fluxo no texto de uma mensagem encapsulada.
HRESULT OpenTaggedBody(
LPMESSAGE lpMessage,
ULONG ulFlags,
LPSTREAM FAR * lppStream
);
Parâmetros
lpMessage
[in] Um ponteiro para a mensagem à qual o fluxo está associado. Esta mensagem não tem de ser a mesma mensagem que é transmitida na chamada para a função OpenTnefStream ou OpenTnefStreamEx .
ulFlags
[in] Uma máscara de bits de sinalizadores que controla a forma como a interface de transmissão é aberta. Os seguintes sinalizadores podem ser definidos:
MAPI_CREATE
Se não existir uma propriedade na mensagem atual, deve ser criada. Se a propriedade existir, os dados atuais na propriedade devem ser substituídos pelos dados do fluxo Transport-Neutral Encapsulation Format (TNEF). Quando uma implementação define o sinalizador MAPI_CREATE, também deve definir o sinalizador MAPI_MODIFY.
MAPI_MODIFY
Pede permissão de leitura/escrita. A interface predefinida é só de leitura. MAPI_MODIFY tem de ser definida sempre que MAPI_CREATE estiver definida.
lppStream
[fora] Um ponteiro para um ponteiro para um objeto de fluxo que contém o texto da propriedade PR_BODY (PidTagBody) da mensagem encapsulada transmitida e que suporta a interface IStream .
Valor de retorno
S_OK
A chamada foi efetuada com êxito e devolveu os valores ou valores esperados.
Comentários
Os fornecedores de transporte, os fornecedores de arquivo de mensagens e os gateways chamam o método ITnef::OpenTaggedBody para abrir uma interface de fluxo no texto de uma mensagem encapsulada (ou seja, num objeto TNEF).
Como parte do respetivo processamento, o OpenTaggedBody insere ou analisa etiquetas de anexo que indicam a posição de quaisquer anexos ou objetos OLE no texto da mensagem. As etiquetas de anexo estão no seguinte formato:
[[nome do anexo:nnonome do contentor de anexo]]
O nome do anexo descreve o objeto de anexo; n é um número que identifica o anexo que faz parte de uma sequência, incrementando a partir do valor transmitido no parâmetro lpKey da função OpenTnefStream ou OpenTnefStreamEx ; E o nome do contentor de anexos descreve o componente físico onde reside o objeto de anexo.
O OpenTaggedBody lê o texto da mensagem e insere uma etiqueta de anexo onde quer que um objeto de anexo seja originalmente apresentado no texto. O texto da mensagem original não é alterado.
Quando uma mensagem com etiquetas é transmitida para um fluxo, as etiquetas são removidas e os objetos de anexo são relocalizados na posição das etiquetas no fluxo.