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
Scardssp.h
Typbibliothek
Scardssp.tlb
DLL
Scardssp.dll
IID
IID _ IByteBuffer ist als E126F8FE-A7AF-11D0-B88A-00C04FD424B9 definiert.