Função BeginUpdateResourceA (winbase.h)

Artigo
11/20/2024

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 este 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 de retorno

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 é NULL se o arquivo especificado não for um PE, o arquivo não existir ou se o arquivo não puder ser aberto para gravação. Para obter informações de erro estendidas, chame GetLastError.

Observações

É 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 às atualizações de recursos em arquivos que contêm dados de Configuração de Recursos (Configuração de RC): arquivos LN e 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 de atualizações de recursos em arquivos LN e arquivos .mui, ambos contendo dados de configuração de RC; os detalhes das restrições estão na referência para a função UpdateResource.

Exemplos

Para ver um exemplo, atualizando recursos.

Nota

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 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

Conceitual

EndUpdateResource

de referência de

Recursos

UpdateResource

Compartilhar via