Partager via


ILockBytes - Implémentation de la mémoire globale

L’implémentation de la mémoire globale ILockBytes est implémentée sur un objet de tableau d’octets sous-jacent à un objet de stockage de fichiers COM composés et conçue pour lire et écrire directement dans la mémoire globale.

Quand l’utiliser

Les méthodes d’ILockBytes sont appelées à partir des implémentations de fichiers composés d’IStorage et d’IStream sur l’objet de stockage de fichiers composés créé par le biais d’un appel à StgCreateDocfile.

Notes

Voici les méthodes de l’implémentation de la mémoire globale ILockBytes .

ILockBytes::ReadAt

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

ILockBytes::WriteAt

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

ILockBytes::Flush

Contrairement à l’implémentation basée sur des fichiers, l’appel de cette méthode dans l’implémentation globale de la mémoire n’a aucun effet.

ILockBytes::SetSize

Définit la taille du tableau d’octets.

ILockBytes::LockRegion

Cette implémentation ne prend pas en charge le verrouillage, donc dwLocksType est défini sur zéro. L’appelant doit s’assurer que les accès sont valides et mutuellement exclusifs.

ILockBytes::UnlockRegion

Cette implémentation ne prend pas en charge le verrouillage.

ILockBytes::Stat

L’implémentation IStorage::Stat fournie par COM appelle la méthode ILockBytes::Stat pour récupérer des données sur l’objet 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