Share via


ILockBytes ::Flush, méthode (objidl.h)

La méthode 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.

Syntaxe

HRESULT Flush();

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK L’opération de vidage a réussi.
STG_E_ACCESSDENIED L’appelant n’est pas autorisé à accéder au tableau d’octets.
STG_E_MEDIUMFULL L’opération de vidage n’est pas terminée, car il n’y a plus d’espace sur le périphérique de stockage.
E_FAIL Échec général lors de l’écriture des données.
STG_E_TOOMANYFILESOPEN Dans certaines circonstances, la méthode Flush exécute un vidage download-and-closeto, ce qui peut entraîner une valeur de retour de STG_E_TOOMANYFILESOPEN si aucun descripteur de fichier n’est disponible.
STG_E_INVALIDHANDLE Un fichier sous-jacent a été fermé prématurément ou la bonne disquette a été remplacée par une autre non valide.

Remarques

ILockBytes ::Flush vide les mémoires tampons internes sur le périphérique de stockage sous-jacent.

L’implémentation de fichiers composés fournie par COM appelle cette méthode lors d’une opération de validation transactionnée pour fournir un processus de validation en deux phases qui protège contre la perte de données.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objidl.h
Bibliothèque Uuid.lib
DLL Ole32.dll

Voir aussi

ILockBytes - Implémentation File-Based

ILockBytes - Implémentation de la mémoire globale

IStorage ::Commit