Propriedade Canônica PidTagAttachMethod

Artigo
04/04/2023

Aplica-se a: Outlook 2013 | Outlook 2016

Contém uma constante definida pelo MAPI que representa a forma como o conteúdo de um anexo pode ser acessado.

Propriedade	Valor
Propriedades associadas:	PR_ATTACH_METHOD
Identificador:	0x3705
Tipo de dados:	PT_LONG
Área:	Anexo de mensagem

Comentários

Essa propriedade pode ter exatamente um dos seguintes valores:

NO_ATTACHMENT

O anexo acabou de ser criado.

ATTACH_BY_VALUE

A propriedade PR_ATTACH_DATA_BIN (PidTagAttachDataBinary) contém os dados de anexo.

ATTACH_BY_REFERENCE

A propriedade PR_ATTACH_PATHNAME (PidTagAttachPathname) ou PR_ATTACH_LONG_PATHNAME (PidTagAttachLongPathname) contém um caminho totalmente qualificado que identifica o anexo a destinatários com acesso a um servidor de arquivo comum.

ATTACH_BY_REF_RESOLVE

A propriedade PR_ATTACH_PATHNAME ou PR_ATTACH_LONG_PATHNAME contém um caminho totalmente qualificado que identifica o anexo.

ATTACH_BY_REF_ONLY

A propriedade PR_ATTACH_PATHNAME ou PR_ATTACH_LONG_PATHNAME contém um caminho totalmente qualificado que identifica o anexo.

ATTACH_EMBEDDED_MSG

A propriedade PR_ATTACH_DATA_OBJ (PidTagAttachDataObject) contém um objeto inserido que dá suporte à interface IMessage .

ATTACH_OLE

O anexo é um objeto OLE inserido.

ATTACH_BY_WEBREFERENCE

O conteúdo do anexo não está na mensagem.

Quando criados, todos os objetos de anexo têm um valor PR_ATTACH_METHOD inicial de NO_ATTACHMENT.

Aplicativos cliente e provedores de serviços são necessários apenas para dar suporte ao método de anexo representado pelo valor ATTACH_BY_VALUE . Os outros métodos de anexo são opcionais. O repositório de mensagens não impõe nenhuma consistência entre o valor de PR_ATTACH_METHOD e os valores das outras propriedades de anexo.

Nomes unc (convenção de nomenclatura universal) são recomendados para caminhos totalmente qualificados, que devem ser usados com ATTACH_BY_REFERENCE e ATTACH_BY_REF_ONLY. Com ATTACH_BY_REF_RESOLVE, um caminho absoluto é mais rápido, pois o spooler MAPI converte o anexo em ATTACH_BY_VALUE.

Se ATTACH_BY_REFERENCE estiver definida, PR_ATTACH_DATA_BIN deverá estar vazia. Um gateway de saída pode transformar um anexo ATTACH_BY_REFERENCE em um anexo ATTACH_BY_VALUE copiando os dados de anexo na propriedade PR_ATTACH_DATA_BIN .

Se ATTACH_BY_REF_RESOLVE estiver definido, PR_ATTACH_DATA_BIN deverá estar vazio. Quando a mensagem que contém o anexo ATTACH_BY_REF_RESOLVE é enviada, o spooler MAPI copia os dados de anexo em um anexo ATTACH_BY_VALUE . Esse processo de resolução coloca os dados de anexo em PR_ATTACH_DATA_BIN.

Se ATTACH_BY_REF_ONLY estiver definida, PR_ATTACH_DATA_BIN deverá estar vazia e o sistema de mensagens nunca resolverá a referência de anexo. Use esse valor quando quiser enviar o link, mas não os dados.

Quando o objeto OLE está no formato OLE 2.0 IStorage , os dados são acessíveis por meio de PR_ATTACH_DATA_OBJ. Quando o objeto OLE está no formato OLE 1.0 OLESTREAM , os dados são acessíveis por meio de PR_ATTACH_DATA_BIN como um IStream. O tipo da codificação OLE pode ser determinado pelo valor PR_ATTACH_TAG (PidTagAttachTag).

Para obter mais informações sobre interfaces e formatos OLE, consulte a Referência do Programador OLE.

Quando o PR_ATTACH_METHOD é ATTACH_BY_WEBREFERENCE, o conteúdo do anexo não está na mensagem. Em vez disso, a propriedade PR_ATTACH_LONG_FILENAME contém uma URL absoluta para o conteúdo do anexo, que é armazenado online.