API Reference

Class

EmailStorePstWriter

Namespace OfficeIMO.Email.Store
Assembly OfficeIMO.Email
Implements
IDisposable
Modifiers sealed

Incrementally creates a new dependency-free Unicode PST. Source PST/OST files are never modified.

Inheritance

  • Object
  • EmailStorePstWriter

Usage

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Returned or exposed by

Methods

public Void Abandon() #
Returns: Void

Marks this incomplete writer for cleanup instead of checkpoint retention on disposal.

AddFolder 2 overloads
public String AddFolder(String name, String parentFolderId = null, String containerClass = null) #
Returns: String

Adds a folder. A null parent places it under RootFolderId.

Parameters

name System.String requiredposition: 0
parentFolderId System.String = null optionalposition: 1
containerClass System.String = null optionalposition: 2
public String AddFolder(String name, EmailStoreSpecialFolderKind specialFolderKind, String parentFolderId = null, String containerClass = null) #
Returns: String

Adds a folder with a supported standard Outlook default-folder identity.

Parameters

name System.String requiredposition: 0
specialFolderKind OfficeIMO.Email.Store.EmailStoreSpecialFolderKind requiredposition: 1
parentFolderId System.String = null optionalposition: 2
containerClass System.String = null optionalposition: 3
public String AddItem(String folderId, EmailDocument document, Boolean isAssociated = false, CancellationToken cancellationToken = null) #
Returns: String

Writes one message or typed Outlook item into a folder.

Parameters

folderId System.String requiredposition: 0
document OfficeIMO.Email.EmailDocument requiredposition: 1
isAssociated System.Boolean = false optionalposition: 2
cancellationToken System.Threading.CancellationToken = null optionalposition: 3
public static Boolean CanAssignSpecialFolderKind(EmailStoreSpecialFolderKind specialFolderKind) #
Returns: Boolean

Returns whether a user-created folder can receive this standard EntryID-backed role.

Parameters

specialFolderKind OfficeIMO.Email.Store.EmailStoreSpecialFolderKind requiredposition: 0
public Void Checkpoint() #
Returns: Void

Flushes all working data and atomically commits a resumable integrity-checked checkpoint.

public EmailStorePstWriteReport Complete(CancellationToken cancellationToken = null) #
Returns: EmailStorePstWriteReport

Finalizes indexes and allocation maps, then atomically commits the PST.

Parameters

cancellationToken System.Threading.CancellationToken = null optionalposition: 0
public static EmailStorePstWriter Create(String destinationPath, EmailStorePstWriterOptions options = null) #
Returns: EmailStorePstWriter

Creates a writer targeting a new PST path.

Parameters

destinationPath System.String requiredposition: 0
options OfficeIMO.Email.Store.EmailStorePstWriterOptions = null optionalposition: 1
public static Void DeleteCheckpoint(String checkpointPath) #
Returns: Void

Deletes a checkpoint and its exact writer-owned working files. A missing checkpoint is a no-op.

Parameters

checkpointPath System.String requiredposition: 0
public virtual Void Dispose() #
Returns: Void
public static EmailStorePstWriter Resume(String checkpointPath, IProgress<EmailStorePstWriteProgress> progress = null) #
Returns: EmailStorePstWriter

Resumes a writer from its last integrity-checked durable checkpoint.

Parameters

checkpointPath System.String requiredposition: 0
progress System.IProgress{OfficeIMO.Email.Store.EmailStorePstWriteProgress} = null optionalposition: 1

Properties

public String CheckpointPath { get; } #

Configured durable checkpoint path, or null when resumability is disabled.

public String RootFolderId { get; } #

Identifier of the mandatory Top of Personal Folders container.