Função EndUpdateResourceA (winbase.h)

Artigo
11/20/2024

Confirma ou descarta alterações feitas antes de uma chamada para UpdateResource.

Sintaxe

BOOL EndUpdateResourceA(
  [in] HANDLE hUpdate,
  [in] BOOL   fDiscard
);

Parâmetros

[in] hUpdate

Tipo: HANDLE

Um identificador de módulo retornado pela função BeginUpdateResource e usado por UpdateResource, fazendo referência ao arquivo a ser atualizado.

[in] fDiscard

Tipo: BOOL

Indica se as atualizações de recurso devem ser gravadas no arquivo. Se esse parâmetro for TRUE, nenhuma alteração será feita. Se for FALSE, as alterações serão feitas: as atualizações de recurso entrarão em vigor.

Valor de retorno

Tipo: BOOL

Retorna verdadeiro se a função for bem-sucedida; false caso contrário. Se a função for bem-sucedida e fDiscard for VERDADEIRO, nenhuma atualização de recurso será feita no arquivo; caso contrário, todas as atualizações de recursos bem-sucedidas são feitas no arquivo. Para obter informações de erro estendidas, chame GetLastError.

Observações

Antes de chamar essa função, verifique se todos os identificadores de arquivo que não sejam os retornados por BeginUpdateResource estão fechados.

Essa função pode atualizar recursos em módulos que contêm código e recursos. Há restrições de atualizações de recursos em arquivos LN e arquivos .mui, ambos contendo dados de Configuração de Recursos; os detalhes das restrições estão na referência para a função UpdateResource.

Exemplos

Para obter um exemplo, consulte Atualizando recursos.

Nota

O cabeçalho winbase.h define EndUpdateResource como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

BeginUpdateResource

Conceitual

de referência de

Recursos

UpdateResource

Compartilhar via