IByteBuffer::Commit-Methode
[Die Commit-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die IStream-Schnittstelle bietet ähnliche Funktionen.]
Die Commit-Methode stellt sicher, dass alle Änderungen, die an einem im Transaktionsmodus geöffneten Objekt vorgenommen werden, im übergeordneten Speicher widergespiegelt werden.
Syntax
HRESULT Commit(
[in] LONG grfCommitFlags
);
Parameter
-
grfCommitFlags [in]
-
Steuert, auf welche Weise ein Commit für die Änderungen am Streamobjekt ausgeführt wird. Eine Definition dieser Werte finden Sie in der STGC-Enumeration.
Rückgabewert
Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass der Aufruf erfolgreich war.
Bemerkungen
Diese Methode stellt sicher, dass Änderungen an einem im Transaktionsmodus geöffneten Streamobjekt im übergeordneten Speicher widergespiegelt werden. Änderungen, die seit dem Öffnen oder letzten Commit am Stream vorgenommen wurden, werden auf das übergeordnete Speicherobjekt reflektiert. Wenn das übergeordnete Element im Transaktionsmodus geöffnet wird, rückgängig machen das übergeordnete Element möglicherweise zu einem späteren Zeitpunkt noch ein Rollback der Änderungen an diesem Streamobjekt. Die Implementierung von zusammengesetzten Dateien unterstützt das Öffnen von Datenströmen im Transaktionsmodus nicht, sodass diese Methode nur sehr wenig Auswirkungen hat, als Speicherpuffer zu leeren.
Beispiele
Das folgende Beispiel zeigt das Commit von Änderungen an den Speicher.
HRESULT hr;
// Commit the buffer.
hr = pIByteBuff->Commit(STGC_DEFAULT | STGC_CONSOLIDATE);
if (FAILED(hr))
printf("Failed IByteBuffer::Commit\n");
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_IByteBuffer ist definiert als E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |