Leggere in inglese

Condividi tramite


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.

Sintassi

HRESULT Commit(
  [in] LONG grfCommitFlags
);

Parametri

grfCommitFlags [in]

Controlla la modalità di esecuzione del commit delle modifiche dell'oggetto flusso. Per una definizione di questi valori, vedere l'enumerazione STGC.

Valore restituito

Il valore restituito è un HRESULT. Un valore di S_OK indica che la chiamata ha avuto esito positivo.

Commenti

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.

Esempio

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");

Requisiti

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
Scardssp.h
Libreria dei tipi
Scardssp.tlb
DLL
Scardssp.dll
IID
IID_IByteBuffer è definito come E126F8FE-A7AF-11D0-B88A-00C04FD424B9