Share via

Método IPropertyStore::Commit (propsys.h)

  • Artigo

Depois que uma alteração for feita, esse método salvará as alterações.

Sintaxe

HRESULT Commit();

Valor retornado

O IPropertyStore::Commit método retorna qualquer um dos seguintes:

Código de retorno Descrição
S_OK
 Todas as alterações de propriedade foram gravadas com êxito no fluxo ou caminho. Isso inclui o caso em que nenhuma alteração estava pendente quando o método foi chamado e nada foi gravado.
STG_E_ACCESSDENIED
 O fluxo ou arquivo é somente leitura; o método não pôde definir o valor.
E_FAIL
 Algumas ou todas as alterações não puderam ser gravadas no arquivo. Outro erro mais explicativo pode ser usado no lugar de E_FAIL.

Comentários

Antes que o Commit método retorne, ele libera o fluxo de arquivo ou caminho que foi inicializado para ser usado pelo método . Portanto, nenhum método IPropertyStore é bem-sucedido após Commit o retorno. Nesse ponto, eles retornam E_FAIL.

Os manipuladores de propriedades devem garantir que as alterações de propriedade resultem em um arquivo de destino válido, mesmo que o Commit processo seja encerrado anormalmente ou encontre erros.

Requisitos

   
Cliente mínimo com suporte Disponível com o Windows Vista e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho propsys.h
Biblioteca Propsys.idl
IRQL Todos os níveis

Confira também

Ipropertystore