Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

API Reference

Class

EmailStorePstWriter

Namespace OfficeIMO.Email.Store
Assembly OfficeIMO.Email
Source revision a039964de4cc with working tree changes
Implements
IDisposable
Modifiers sealed

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

Inheritance

  • Object
  • EmailStorePstWriter

Usage

Explore 2 API references to this type

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

Returned or exposed by 2

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 EmailStorePstWriter.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 = default) #
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 = default 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
Checkpoint 2 overloads
public Void Checkpoint() #
Returns: Void

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

public Void Checkpoint(Byte[]? applicationState) #
Returns: Void

Flushes writer data and atomically commits bounded caller state in the same integrity-checked checkpoint.

Parameters

applicationState System.Byte[]? requiredposition: 0
public EmailStorePstWriteReport Complete(CancellationToken cancellationToken = default) #
Returns: EmailStorePstWriteReport

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

Parameters

cancellationToken System.Threading.CancellationToken = default 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 Void Dispose() #
Returns: Void

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Resume 2 overloads
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
public static EmailStorePstWriter Resume(String checkpointPath, out Byte[]? applicationState, IProgress<EmailStorePstWriteProgress>? progress = null) #
Returns: EmailStorePstWriter

Resumes a writer and returns caller state committed atomically with the writer checkpoint.

Parameters

checkpointPath System.String requiredposition: 0
applicationState System.Byte[]? requiredposition: 1
progress System.IProgress<OfficeIMO.Email.Store.EmailStorePstWriteProgress>? = null optionalposition: 2

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.