Método IByteBuffer::Commit

[El método Commit está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La interfaz IStream proporciona una funcionalidad similar.]

El método Commit garantiza que los cambios realizados en un objeto abierto en modo transaccionado se reflejen en el almacenamiento primario.

Sintaxis

HRESULT Commit(
  [in] LONG grfCommitFlags
);

Parámetros

grfCommitFlags [in]

Controla la forma en que se confirman los cambios realizados en un objeto de secuencia. Para obtener una definición de estos valores, consulte la enumeración STGC.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que la llamada se realizó correctamente.

Comentarios

Este método garantiza que los cambios en un objeto de secuencia abierto en modo transaccionado se reflejen en el almacenamiento primario. Los cambios realizados en la secuencia desde que se abrió o se confirmaron por última vez se reflejan en el objeto de almacenamiento primario. Si el elemento primario se abre en modo de transacción, es posible que el elemento primario se revierta posteriormente a la reversión de los cambios en este objeto de secuencia. La implementación del archivo compuesto no admite la apertura de secuencias en modo transaccionado, por lo que este método tiene muy poco efecto aparte de vaciar los búferes de memoria.

Ejemplos

En el ejemplo siguiente se muestran los cambios confirmados en el almacenamiento.

HRESULT  hr;

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
Archivo DLL	Scardssp.dll
IID	IID_IByteBuffer se define como E126F8FE-A7AF-11D0-B88A-00C04FD424B9