Freigeben über

OLFI

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Warteschlange mit langfristigen ID-Strukturen, die vom PST-Speicheranbieter (Personal Folders File) verwendet werden, um eine Eintrags-ID für eine neue Nachricht oder einen neuen Ordner im Offlinemodus zuzuweisen.

QuickInfo

typedef struct { 
    ULONG    ulVersion; 
    MAPIUID  muidReserved; 
    ULONG    ulReserved; 
    DWORD    dwAlloc; 
    DWORD    dwNextAlloc; 
    LTID     ltidAlloc; 
    LTID     ltidNextAlloc; 
} OLFI, *POLFI;

Members

ulVersion

  • Versionsnummer für die Struktur.

muidReserved

  • Dieses Mitglied ist für die interne Verwendung von Outlook reserviert und wird nicht unterstützt.

ulReserved

  • Dieses Mitglied ist für die interne Verwendung von Outlook reserviert und wird nicht unterstützt.

dwAlloc

  • Die Anzahl der Einträge, die für die Zuordnung verfügbar sind. Diese Einträge verwenden dieselbe GUID (Globally Unique Identifier).

dwNextAlloc

  • Die Anzahl der Einträge, die als Nächstes für die Zuordnung verfügbar sind. Diese Einträge verwenden dieselbe GUID.

ltidAlloc

  • Die langfristige ID-Struktur LTID, die den eintrag identifiziert, der derzeit für die Zuordnung verfügbar ist. Die Langfristige ID-Struktur enthält eine GUID und einen Index, der ein Objekt im Speicher identifiziert. Zusammen können die GUID und der Index eine eindeutige Eintrags-ID für ein Objekt bilden.

ltidNextAlloc

  • Langfristige ID-Struktur, die den nächsten verfügbaren Eintrag identifiziert.

Hinweise

Eine Eintrags-ID ist ein 4-Byte-MAPI-Eintragsbezeichner für einen Ordner oder eine Nachricht. Weitere Informationen finden Sie unter ENTRYID.

Wenn ein PST-Speicheranbieter einem neuen Objekt eine Eintrags-ID zuweist, benötigt er zunächst eine GUID, die den Server identifiziert, und einen Index, der das Objekt im Speicher identifiziert. Obwohl die GUID nicht für alle Eintrags-IDs eindeutig ist, stellen die GUID und der Index zusammen einen eindeutigen Eintrag bereit. Dieses GUID- und Indexpaar wird durch die langfristige ID-Struktur LTID nachverfolgt, die Teil der OLFI-Struktur ist.

Der PST-Speicheranbieter behält nicht physisch eine LTID-Struktur für jedes GUID-Indexpaar in OLFI bei. Es behält eine LTID-Struktur , ltidAlloc, für das derzeit erste verfügbare GUID-Index-Paar bei. eine Anzahl ( dwAlloc) der Anzahl der verfügbaren Einträge, die dieselbe GUID verwenden; und eine zweite LTID-Struktur , ltidNextAlloc, für das nächste verfügbare GUID-Index-Paar, das eine andere GUID aufweist. Der PST-Speicheranbieter verwendet die OLFI-Struktur , um die von ihm verteilten GUIDs und Indizes nachzuverfolgen. Auf einer virtuellen Ebene verwaltet der Anbieter eine Reserve einer Reihe von LTID-Strukturen , die zugeordnet werden können. dwAlloc verwaltet die Anzahl der verfügbaren LTID-Strukturen .

Anforderungen für Eingabe-IDs werden in Blöcken bereitgestellt. Wenn eine Anforderung für einen Block vorhanden ist, überprüft der PST-Speicheranbieter, ob genügend Reserve vorhanden ist, indem er die angeforderte Größe mit dwAlloc vergleicht. Wenn genügend Reserve vorhanden ist, werden die GUID und der Index in ltidAlloc für die Zuordnung zurückgegeben. Anschließend wird dwAlloc um die angeforderte Größe verringert und der Index in ltidAlloc um die angeforderte Größe erhöht. Dadurch wird der PST-Speicheranbieter darauf vorbereitet, ltidAlloc bei der nächsten Anforderung für einen anderen Block von Eintrags-IDs zuzuweisen. Beachten Sie, dass die GUID für die nächste Anforderung unverändert bleibt.

Wenn die Größe einer Anforderung größer als dwAlloc ist, versucht der PST-Speicheranbieter, wie von dwNextAlloc und ltidNextAlloc angegeben, das nächste Element in reserve zu verwenden. Es kopiert dwNextAlloc und ltidNextAlloc in dwAlloc bzw. ltidAlloc und legt dwNextAlloc und ltidNextAlloc auf NULL fest.

Ein Anbieter, der den PST-Speicheranbieter umschließt, sollte in regelmäßigen Abständen ltidNextAlloc überprüfen, ob es NULL ist. Wenn dies der Grund ist, sollte der Anbieter ihn mit einer neuen GUID auffüllen und dwNextAlloc zurücksetzen, damit weitere Eingabe-IDs zugewiesen werden können.

Siehe auch

Informationen zur Replikations-APIInformationen zum ReplikationsstatuscomputerLTID