Metodo IByteBuffer::Commit
[Il metodo Commit è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'interfaccia IStream offre funzionalità simili.
Il metodo Commit garantisce che tutte le modifiche apportate a un oggetto aperto in modalità transacted vengano riflesse nell'archiviazione padre.
HRESULT Commit(
[in] LONG grfCommitFlags
);
-
grfCommitFlags [in]
-
Controlla la modalità di esecuzione del commit delle modifiche dell'oggetto flusso. Per una definizione di questi valori, vedere l'enumerazione STGC.
Il valore restituito è un HRESULT. Un valore di S_OK indica che la chiamata ha avuto esito positivo.
Questo metodo garantisce che le modifiche a un oggetto di flusso aperto in modalità transacted vengano riflesse nell'archiviazione padre. Le modifiche apportate al flusso dopo l'apertura o l'ultimo commit vengono riflesse nell'oggetto di archiviazione padre. Se l'elemento padre viene aperto in modalità transazionata, l'elemento padre potrebbe comunque tornare nuovamente in un secondo momento al rollback delle modifiche apportate a questo oggetto di flusso. L'implementazione del file composto non supporta l'apertura dei flussi in modalità transazionata, quindi questo metodo ha un effetto molto piccolo diverso da quello di scaricare i buffer di memoria.
Nell'esempio seguente viene illustrato il commit delle modifiche apportate all'archiviazione.
HRESULT hr;
// Commit the buffer.
hr = pIByteBuff->Commit(STGC_DEFAULT | STGC_CONSOLIDATE);
if (FAILED(hr))
printf("Failed IByteBuffer::Commit\n");
Requisito | Valore |
---|---|
Client minimo supportato |
Windows XP [solo app desktop] |
Server minimo supportato |
Windows Server 2003 [solo app desktop] |
Fine del supporto client |
Windows XP |
Fine del supporto server |
Windows Server 2003 |
Intestazione |
|
Libreria dei tipi |
|
DLL |
|
IID |
IID_IByteBuffer è definito come E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |