Método IByteBuffer::Commit

[O método Commit está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A interface IStream fornece funcionalidade semelhante.]

O método Commit garante que todas as alterações feitas em um objeto aberto no modo transacionado sejam refletidas no armazenamento pai.

Sintaxe

HRESULT Commit(
  [in] LONG grfCommitFlags
);

Parâmetros

grfCommitFlags [in]

Controla como as alterações no objeto de fluxo são confirmadas. Para obter uma definição desses valores, consulte a enumeração STGC.

Valor retornado

O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.

Comentários

Esse método garante que as alterações em um objeto de fluxo aberto no modo transacionado sejam refletidas no armazenamento pai. As alterações feitas no fluxo desde que ele foi aberto ou confirmado pela última vez são refletidas no objeto de armazenamento pai. Se o pai for aberto no modo transacionado, o pai ainda poderá reverter posteriormente revertendo as alterações nesse objeto de fluxo. A implementação de arquivo composto não dá suporte à abertura de fluxos no modo transacionado, portanto, esse método tem muito pouco efeito além de liberar buffers de memória.

Exemplos

O exemplo a seguir mostra a confirmação de alterações no armazenamento.

HRESULT  hr;

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Fim do suporte ao cliente	Windows XP
Fim do suporte ao servidor	Windows Server 2003
Cabeçalho	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9