IByteBuffer::Commit, méthode

Article
06/13/2023

[La méthode Commit est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’interface IStream fournit des fonctionnalités similaires.]

La méthode Commit garantit que toutes les modifications apportées à un objet ouvert en mode transactionné sont répercutées dans le stockage parent.

Syntaxe

HRESULT Commit(
  [in] LONG grfCommitFlags
);

Paramètres

grfCommitFlags [in]: Contrôle comment les modifications apportées à un objet de flux sont validées. Pour obtenir une définition de ces valeurs, consultez l’énumération STGC.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique que l’appel a réussi.

Notes

Cette méthode garantit que les modifications apportées à un objet de flux ouvert en mode transactionné sont répercutées dans le stockage parent. Les modifications qui ont été apportées au flux depuis son ouverture ou sa dernière validation sont répercutées sur l’objet de stockage parent. Si le parent est ouvert en mode transactionné, le parent peut toujours revenir ultérieurement à la restauration des modifications apportées à cet objet de flux. L’implémentation de fichiers composés ne prend pas en charge l’ouverture de flux en mode transactionné, de sorte que cette méthode a très peu d’effet autre que de vider les mémoires tampons.

Exemples

L’exemple suivant montre la validation des modifications apportées au stockage.

HRESULT  hr;

// Commit the buffer.
hr = pIByteBuff->Commit(STGC_DEFAULT | STGC_CONSOLIDATE);
if (FAILED(hr))
  printf("Failed IByteBuffer::Commit\n");

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003
En-tête	Scardssp.h
Bibliothèque de types	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer est défini comme E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Partager via