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.GetProfileInventory(System.Object,System.Threading.CancellationToken)">
            <summary>
            Reads every account and data file of the connected profile without opening a folder or touching an item. Standard
            folder discovery is unavailable for Exchange and OST stores below Outlook 2010; this stays readable where it is not.
            </summary>
            <returns>Plain records. No COM reference is retained and the namespace stays borrowed.</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.OutlookAccountKind">
            <summary>OlAccountType. Unknown preserves an unrecognized provider value instead of inferring a behavior from it.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookDataFileFormat">
            <summary>Backing file shape of a store. None describes a store with no local file, such as Exchange in online mode.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookAccountInfo">
            <summary>One account in the current profile and the store it delivers new mail into.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookAccountInfo.AccountType">
            <summary>Raw OlAccountType, retained so an unmapped provider value stays reportable.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookAccountInfo.KindName">
            <summary>Provider label as Outlook's own account list names it, or the raw value when unmapped.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookAccountInfo.Evidence">
            <summary>Provider errors met while reading this account. Empty when every property was readable.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookAccountInfo.IsServerSynchronized">
            <summary>Folders mirror server state, so local removals can reach the server and other clients.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookAccountInfo.MayDeferItemBodies">
            <summary>
            The provider can leave an item as a header-only stub. A file extension cannot establish this: Outlook 2007 backs an
            IMAP account with a PST, so the owning account is the only reliable signal that bodies may still be on the server.
            </summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookStoreInfo">
            <summary>One data file or mailbox in the current profile, with the accounts that depend on it.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.DataFileFormatName">
            <summary>Backing file shape as the Outlook data file dialog names it: PST, OST, None, or Other.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.ExchangeStoreType">
            <summary>Raw OlExchangeStoreType, or -1 when the provider did not report one.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.SizeBytes">
            <summary>File length in bytes, or null when the file is absent or unreadable. Outlook holding it open does not prevent the read.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.DeliveredFrom">
            <summary>Display names of the accounts that deliver new mail here. Correlated by StoreID, because display names repeat.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.IsExchangeBacked">
            <summary>olNotExchange (3) is the only value that proves a store is not served by Exchange. An unreported type counts as Exchange-backed.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.IsSynchronized">
            <summary>Changes here can reach a server and other clients.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.MayContainHeaderOnlyItems">
            <summary>Items here can be header-only stubs, so a transfer must verify each body first.</summary>
        </member>
        <member name="P:AdNoctem.Substrate.Interop.OutlookStoreInfo.Evidence">
            <summary>Why the store carries the classification above, including any provider error behind it.</summary>
        </member>
        <member name="T:AdNoctem.Substrate.Interop.OutlookProfileInventory">
            <summary>Accounts and stores of one profile, read together so each store can state what depends on it.</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>