OLFI

S’applique à : Outlook 2013 | Outlook 2016

File d’attente des structures d’ID à long terme utilisées par le fournisseur de magasin de fichiers de dossiers personnels (PST) pour attribuer un ID d’entrée à un nouveau message ou dossier en mode hors connexion.

Informations rapides

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

Members

ulVersion

• Numéro de version de la structure.

muidReserved

• Ce membre est réservé à l’utilisation interne d’Outlook et n’est pas pris en charge.

ulReserved

• Ce membre est réservé à l’utilisation interne d’Outlook et n’est pas pris en charge.

dwAlloc

• Nombre d’entrées disponibles pour l’allocation. Ces entrées partagent le même identificateur global unique (GUID).

dwNextAlloc

• Nombre d’entrées disponibles ensuite pour l’allocation. Ces entrées partagent le même GUID.

ltidAlloc

• Structure d’ID à long terme, LTID, identifiant l’entrée actuellement disponible pour l’allocation. La structure d’ID à long terme contient un GUID et un index identifiant un objet dans le magasin. Ensemble, le GUID et l’index peuvent former un ID d’entrée unique pour un objet.

ltidNextAlloc

• Structure d’ID à long terme identifiant l’entrée disponible suivante.

Remarques

Un ID d’entrée est un identificateur d’entrée MAPI de 4 octets pour un dossier ou un message. Pour plus d’informations, consultez ENTRYID.

Lorsqu’un fournisseur de magasin PST affecte un ID d’entrée à un nouvel objet, il a d’abord besoin d’un GUID qui identifie le serveur et d’un index qui identifie l’objet dans le magasin. Même si le GUID n’est pas unique sur tous les ID d’entrée, le GUID et l’index combinés fournissent une entrée unique. Cette paire GUID-index est suivie par une structure d’ID à long terme, LTID, qui fait partie de la structure OLFI .

Le fournisseur de magasin PST ne conserve pas physiquement dans OLFI une structure LTID pour chaque paire GUID-index. Il conserve une structure LTID , ltidAlloc, pour la première paire GUID-index actuellement disponible ; un décompte, dwAlloc, du nombre d’entrées disponibles qui partagent ce même GUID ; et une deuxième structure LTID , ltidNextAlloc, pour la paire GUID-index disponible suivante qui a un GUID différent. Le fournisseur de magasin PST utilise la structure OLFI pour suivre les GUID et les index qu’il a distribués. Au niveau virtuel, le fournisseur gère une réserve de plusieurs structures LTID prêtes à être allouées. dwAlloc conserve le nombre de structures LTID disponibles.

Les demandes d’ID d’entrée se présentent par blocs. En cas de demande de bloc, le fournisseur du magasin PST vérifie s’il existe une réserve suffisante en comparant la taille demandée à dwAlloc. Si la réserve est suffisante, elle retourne le GUID et l’index dans ltidAlloc pour l’allocation. Il diminue ensuite dwAlloc de la taille demandée et incrémente l’index dans ltidAlloc de la taille demandée. Cela prépare le fournisseur de magasin PST à allouer ltidAlloc lors de la requête suivante pour un autre bloc d’ID d’entrée. Notez que le GUID reste le même pour la requête suivante.

Si la taille d’une requête est supérieure à dwAlloc, le fournisseur de magasin PST tente d’utiliser ce qu’il a ensuite en réserve, comme spécifié par dwNextAlloc et ltidNextAlloc. Il copie dwNextAlloc et ltidNextAlloc dans dwAlloc et ltidAlloc respectivement, et définit dwNextAlloc et ltidNextAlloc sur NULL.

Un fournisseur qui encapsule le fournisseur de magasin PST doit régulièrement case activée ltidNextAlloc pour voir s’il est NULL. Si c’est le cas, le fournisseur doit le remplir avec un nouveau GUID et réinitialiser dwNextAlloc afin que d’autres ID d’entrée puissent être alloués.

Voir aussi

À propos de l’API de réplicationÀ propos de l’ordinateur d’état de réplicationLTID