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