lib/Desktop/AdNoctem.Substrate.Interop.xml

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>AdNoctem.Substrate.Interop</name>
    </assembly>
    <members>
        <member name="T:AdNoctem.Substrate.Interop.ComManager">
            <summary>Creates and scopes COM objects with explicit lifetime and apartment requirements.</summary>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.ComManager.ReleaseReference(System.Object)">
            <summary>Releases one reference on an object the caller owns. Never final-releases a shared RCW.
            Returns null for null/non-COM objects. Call on the owning apartment; failures propagate.</summary>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.ComManager.CollectAndWaitForFinalizers">
            <summary>Explicit process-wide collection and finalizer wait. May block; never invoked implicitly by another library operation.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookManager">
            <summary>Classic Outlook automation. COM calls remain synchronous and apartment-bound; cancellation is checked between provider calls.</summary>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.FindRepairTools(System.Collections.Generic.IEnumerable{AdNoctem.Substrate.IO.FileSystemPath},System.Threading.CancellationToken)">
            <remarks>Inspects installed ScanPST and explicit search directories. Does not execute candidates or change process PATH.</remarks>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.GetStandardFolderIdentities(System.Object,System.Object,System.Threading.CancellationToken,System.Action{AdNoctem.Substrate.Interop.OutlookFolderIdentity})">
            <summary>Reads standard-folder identities without creating folders. Individual provider failures remain identity records.</summary>
            <remarks>Non-resolved records are sent to diagnostic when supplied. A failed lookup is not proof of absence.
            Store access, invalid returned identities and cancellation still fail the operation. No COM references escape.</remarks>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.ParseAdditionalFolderEntryIds(System.Byte[])">
            <summary>Parses bounded little-endian PersistData/PersistElement records without accessing Outlook.</summary>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.GetFolderPlan(System.Object,System.Object,System.String,System.Boolean,System.Collections.Generic.IEnumerable{AdNoctem.Substrate.Interop.OutlookFolderKind},System.Collections.Generic.IEnumerable{System.String},System.Action{System.String},System.Threading.CancellationToken,System.Action{System.String})">
            <summary>Collects a read-only folder plan. Null requires Inbox by identity, empty selects the root, otherwise an exact relative path.</summary>
            <remarks>Uncertain excluded identities cause potentially matching branches to be skipped with an IncompleteIdentity reason and a diagnostic.
            Resolved identities and item types constrain classification; names are never used to guess standard kinds.
            No COM references escape. Cancellation and source inspection failures discard partial results. Plans do not authorize mutation.</remarks>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.GetStoreRoot(System.Object,System.String,System.Action{System.String},System.Threading.CancellationToken)">
            <returns>A caller-owned root reference. The namespace is borrowed.</returns>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.AddStoreRoot(System.Object,AdNoctem.Substrate.IO.FileSystemPath,System.Threading.CancellationToken)">
            <summary>Explicitly attaches or creates a Unicode PST. Use OpenPstStore when creation must be forbidden.</summary>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.GetSubFolder(System.Object,System.String,System.Boolean,System.Threading.CancellationToken)">
            <returns>A caller-owned child reference, or null when absent and creation was not requested.</returns>
        </member>
        <member name="M:AdNoctem.Substrate.Interop.OutlookManager.OpenPstStore(System.Object,AdNoctem.Substrate.IO.FileSystemPath,System.Boolean,System.Threading.CancellationToken)">
            <summary>Returns an ownership-aware context for an existing writable local PST, or null if attachment is needed but disallowed.</summary>
            <remarks>Rechecks before attaching; Outlook has no atomic existing-only open. Callers must prevent concurrent file/profile changes.
            Rejects network/reparse paths; short names are expanded but hard-link aliases are not detected. Cancellation after attachment cleans up.</remarks>
        </member>
        <member name="F:AdNoctem.Substrate.Interop.OutlookFolderIdentityState.Absent">
            <summary>The provider reports that the folder does not exist.</summary>
        </member>
        <member name="F:AdNoctem.Substrate.Interop.OutlookFolderIdentityState.Unavailable">
            <summary>The provider does not support this lookup; absence is not established.</summary>
        </member>
        <member name="F:AdNoctem.Substrate.Interop.OutlookFolderIdentityState.Unresolved">
            <summary>The lookup failed or lacks identity evidence; absence is not established.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookSession">
            <summary>Owns acquired application/namespace references. Dispose on the creating thread; never quits Outlook or logs off a shared session.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookPstStore">
            <summary>Owns one root reference and, when indicated, the attachment created by OpenPstStore. The namespace is borrowed.</summary>
            <remarks>Dispose on the creating thread after releasing all child references. Never serialize or share a lifetime across processes.
            Overlapping consumers are not reference-counted. Disposal never deletes a PST or quits Outlook.</remarks>
        </member>
    </members>
</doc>