KeyView 24.4
KeyView HTML Export SDK C Programming Guide

# Default File Names for Extracted Subfiles

When you do not specify a file name in the call to fpExtractSubFile(), in some cases a default file name is applied to the extracted subfile.

## Default File Name for Mail Formats

To avoid naming conflicts and problems with long file names, KeyView applies its own names to the extracted mail items when you do not supply a name in the call to `fpExtractSubFile()`. A non-mail attachment retains its original file name and extension.

When the contents of a mail store or the message body of a mail message are extracted, the extracted file names can include the following:

- The first valid eight characters of the original folder name or "Subject" line of the mail message. If the "Subject" line is empty, the characters `kv` `ext` are used, where `ext` is the format’s extension. For example, the characters would be "`kvmsg`" for MSG and "`kvnsf"` for NSF.

  For notes, the file name is derived from the first 24 characters of the note text. For contact entries, the file name is derived from the full name of the contact.

  The following special characters are considered invalid and are ignored:

  any non-printing character with a value less than `0x1F`
  angle brackets (< >) | double quotation marks (")
  asterisk (*) | forward slash (/)
  back slash (\) | pipe (|)
  colon (:) | question mark (?)

- The characters `_kv` `n`, where `n` is an integer incremented from 0 for each extracted item.

- One of the following extensions:

  Type | File Extension
  email message | `.mail`
  calendar appointment | `.cal`
  contact entry | `.cont`
  task entry | `.task`
  note | `.note`
  journal entry | `.jrnl`
  distribution list | `.dist`
  posting note | `.post`

  - If the type cannot be determined for an MSG or PST file, the file is given a `.mail` extension.

  - If the type cannot be determined for a NSF file, the file is given a `.tmp` extension.

  - The format of a MAIL file is plain text by default, but can be set to RTF with the `KVExtractionFlag_GetFormattedBody` flag.

For example, an MSG mail message with the subject line RE: Product roadmap that contains the Microsoft Excel attachment `release_schedule.xls` is extracted as:

    RE produ_kv0.mail
    release_schedule.xls

If an extracted message contains an embedded OLE object or any attachment that does not have a name, the object or attachment is extracted as `_kv``#``.tmp`.

## Default File Name for Embedded OLE Objects

KeyView can apply a default name to an extracted embedded OLE object when you do not supply a name in the call to `fpExtractSubFile()`. When an embedded OLE object is extracted, the extracted file name can include the following:

- The characters `subfile_kv` `n`, where `n` is an integer incremented from 0 for each extracted object.

- If KeyView can determine the embedded OLE is a Microsoft Office document, the original extension is used. If the file type cannot be determined, the file is given a `.tmp` extension.

For example, a Microsoft Word document (`sales_quarterly.doc`) might contain two embedded OLE objects: a Microsoft Excel file called `west_region.xls`, and a bitmap created in the Word document. The embedded objects are extracted as `subfile_kv0.xls` and `subfile_kv1.tmp`.

Copyright 1997-2024 Open Text
Version 24.4 | Last updated September 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL KeyView 24.4

Topic Title: Default File Names for Extracted Subfiles