Edit

MapiFileTagExt structure (mapi.h)

  • Article

A MapiFileTagExt structure specifies a message attachment's type at its creation and its current form of encoding so that it can be restored to its original type at its destination.

Syntax

typedef struct {
  ULONG  ulReserved;
  ULONG  cbTag;
  LPBYTE lpTag;
  ULONG  cbEncoding;
  LPBYTE lpEncoding;
} MapiFileTagExt, *lpMapiFileTagExt;

Members

ulReserved

Type: ULONG

Reserved; must be zero.

cbTag

Type: ULONG

The size, in bytes, of the value defined by the lpTag member.

lpTag

Type: LPBYTE

Pointer to an X.400 object identifier indicating the type of the attachment in its original form, for example "Microsoft Excel worksheet".

cbEncoding

Type: ULONG

The size, in bytes, of the value defined by the lpEncoding member.

lpEncoding

Type: LPBYTE

Pointer to an X.400 object identifier indicating the form in which the attachment is currently encoded, for example MacBinary, UUENCODE, or binary.

Remarks

A MapiFileTagExt structure defines the type of an attached file for purposes such as encoding and decoding the file, choosing the correct application to launch when opening it, or any use that requires full information regarding the file type. Client applications can use information in the lpTag and lpEncoding members of this structure to determine what to do with an attachment.

Requirements

Requirement Value
Header mapi.h

See also

MapiFileDesc

MapiFileDescW

PidTagAttachEncoding Canonical Property

PidTagAttachTag Canonical Property