Função BeginUpdateResourceA (winbase.h)

Artigo
08/27/2023

Recupera um identificador que pode ser usado pela função UpdateResource para adicionar, excluir ou substituir recursos em um módulo binário.

Sintaxe

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

Parâmetros

[in] pFileName

Tipo: LPCTSTR

O arquivo binário no qual atualizar recursos. Um aplicativo deve ser capaz de obter acesso de gravação a esse arquivo; o arquivo referenciado por pFileName não pode estar em execução no momento. Se pFileName não especificar um caminho completo, o sistema procurará o arquivo no diretório atual.

[in] bDeleteExistingResources

Tipo: BOOL

Indica se os recursos existentes do parâmetro pFileName devem ser excluídos. Se esse parâmetro for TRUE, os recursos existentes serão excluídos e o arquivo atualizado incluirá apenas recursos adicionados com a função UpdateResource . Se esse parâmetro for FALSE, o arquivo atualizado incluirá recursos existentes, a menos que sejam explicitamente excluídos ou substituídos usando UpdateResource.

Valor retornado

Tipo: HANDLE

Se a função for bem-sucedida, o valor retornado será um identificador que pode ser usado pelas funções UpdateResource e EndUpdateResource . O valor retornado será NULL se o arquivo especificado não for um PE, o arquivo não existir ou o arquivo não puder ser aberto para gravação. Para obter informações de erro estendidas, chame GetLastError.

Comentários

É recomendável que o arquivo de recurso não seja carregado antes que essa função seja chamada. No entanto, se esse arquivo já estiver carregado, ele não fará com que um erro seja retornado.

Há algumas restrições em atualizações de recursos em arquivos que contêm dados de Configuração de Recursos (Configuração de RC): arquivos LN e os arquivos .mui associados. Detalhes sobre quais tipos de recursos podem ser atualizados nesses arquivos estão na seção Comentários da função UpdateResource .

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

Exemplos

Para obter um exemplo, consulte Atualizando recursos.

Observação

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

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll