IStream::Commit

9/8/2008

Esse método garante que qualquer as alterações feitas a um objeto transmitir aberto no modo de transação são refletidas no armazenamento de pai.

Se o objeto transmitir é aberto no direcionar modo, IStream::Commit não tem nenhum efeito Other Than liberando memória todos os buffers para o próximo nível objeto armazenamento.

A implementação arquivo composto OLE de fluxos não não suporte abrindo fluxos em modo transacionado.

Syntax

HRESULT Commit( 
  DWORD grfCommitFlags 
);

Parameters

• grfCommitFlags
  [no] Valor que controla como as alterações para o objeto transmitir são confirmadas.

  Para obter uma definição desses valores, consulte o STGC enumeração.

Return Value

A seguinte tabela mostra os valores de retorno para este método.

Valor	Descrição
S_OK	O objeto transmitir as alterações foram confirmadas com êxito para o pai nível.
E_PENDING	Somente armazenamento assíncrono: Parte ou todos os dados de transmitir é atualmente não disponível.
STG_E_MEDIUMFULL	Falha de operação confirmação devido a falta de espaço no dispositivo de armazenamento.
STG_E_REVERTED	O objeto tenha sido invalidado por uma operação de reversão acima na árvore de transação.

Remarks

Esse método garante que as alterações para um objeto transmitir aberto no modo transacionado refletem no armazenamento pai.

As alterações que foram feitas para a transmitir desde que ele foi aberto ou última confirmado são refletidas para o objeto armazenamento pai.

Se o pai for aberto no modo de transação, o pai pode ainda reverter em um tempo posterior, sem interrupção voltar as alterações para este objeto transmitir.

A implementação arquivo composto não suporte fluxos de abertura em modo transacionado, para que este método tem efeito muito pouco Other Than para liberado buffers memória.

Se a transmitir é aberto no direcionar modo, esse método garante que qualquer buffers memória foram liberados saída para o subjacente objeto armazenamento. Isso é muito como um liberado no arquivo tradicionais sistemas.

O IStream::Commit método é útil em um direcionar transmitir modo quando a implementação das IStream interface é um wrapper para subjacente sistema de arquivos APIs. Neste maiúsculas e minúsculas, IStream::Commit deve estar conectado ao do sistema de arquivos liberado chamar.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later