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 transaktionsorientierten Modus 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 Committed am Stream vorgenommen wurden, werden im übergeordneten Speicherobjekt widergespiegelt. Wenn das übergeordnete Element im transaktionsorientierten Modus geöffnet wird, kann das übergeordnete Element zu einem späteren Zeitpunkt noch ein Roll back der Änderungen an diesem Streamobjekt ausführen. Die Verbunddateiimplementierung unterstützt das Öffnen von Datenströmen im transaktiven Modus nicht, daher hat diese Methode nur sehr geringe Auswirkungen als das Leeren von Speicherpuffern.
Beispiele
Das folgende Beispiel zeigt das Committen von Änderungen im Speicher.
HRESULT hr;
// Commit the buffer.
hr = pIByteBuff->Commit(STGC_DEFAULT | STGC_CONSOLIDATE);
if (FAILED(hr))
printf("Failed IByteBuffer::Commit\n");
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ IByteBuffer ist als E126F8FE-A7AF-11D0-B88A-00C04FD424B9 definiert. |