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 .
Rubriques connexes