Partager via


ILockBytes - Implémentation File-Based

Implémenté sur un objet de tableau d’octets sous-jacent à un objet de stockage de fichiers com composés, et conçu pour lire et écrire directement dans un fichier disque.

Quand l’utiliser

Les méthodes de ILockBytes sont appelées à partir des implémentations de fichiers composés de IStorage et IStream sur l’objet de stockage de fichiers composés créé par le biais d’un appel à StgCreateDocfile. Vous n’avez donc pas besoin de les appeler directement.

Notes

Voici les méthodes de iLockBytes File-Based Implementation.

ILockBytes::ReadAt

Lit un bloc d’octets à partir d’un décalage spécifié au début du tableau d’octets.

ILockBytes::WriteAt

Écrit un bloc d’octets à partir d’un décalage spécifié au début du tableau d’octets.

ILockBytes::Flush

Garantit que toutes les mémoires tampons internes gérées par l’implémentation ILockBytes sont écrites dans le stockage physique sous-jacent.

ILockBytes::SetSize

Définit la taille du tableau d’octets.

ILockBytes::LockRegion

Le paramètre dwLockTypes est défini sur LOCK_ONLYONCE ou LOCK_EXCLUSIVE, ce qui autorise ou limite l’accès aux régions verrouillées.

ILockBytes::UnlockRegion

Cette méthode déverrouille la région verrouillée par ILockBytes::LockRegion.

ILockBytes::Stat

L’implémentation IStorage::Stat fournie par COM appelle la méthode ILockBytes::Stat pour récupérer des informations sur l’objet de tableau d’octets. S’il n’existe aucun nom raisonnable pour le tableau d’octets, la méthode ILockBytes::Stat fournie par COM retourne NULL dans le membre pwcsName de la structure STATSTG .

ILockBytes

IStorage

IStream