UpdateResource

A função UpdateResource adiciona, exclui ou substitui um recurso em um arquivo executável.

(BOOL UpdateResource Lidar com  hUpdate, / / identificador de arquivo de atualizaçãoLPCTSTRlpType, / / tipo de endereço do recurso para atualizarLPCTSTRlpName, / / endereço do recurso de nome para atualizarPalavrawLanguage, / / identificador de idioma do recursoLPVOIDlpData, / / endereço de dados de recursosDWORDcbData / / comprimento de dados de recursos, em bytes);
 

Parâmetros

hUpdate
Especifica um identificador de arquivo de atualização. Esse identificador é retornado pela função a BeginUpdateResource.
lpType
Ponteiro para uma seqüência de caracteres null-terminated especificando o tipo de recurso para ser atualizado. Este parâmetro também pode ser um número inteiro valor passado para o MAKEINTRESOURCE macro, ou pode ser um dos seguintes tipos de recurso predefinido:
Valor Significado
RT_ACCELERATOR Tabela de teclas aceleradoras
RT_ANICURSOR Cursor animado
RT_ANIICON Ícone animado
RT_BITMAP Recurso de bitmap
RT_CURSOR Recurso cursor hardware-dependente
RT_DIALOG Caixa de diálogo
RT_FONT Recurso de fonte
RT_FONTDIR Recurso de diretório de fonte
RT_GROUP_CURSOR Recurso cursor hardware-independent
RT_GROUP_ICON Recurso ícone hardware-independent
RT_HTML Documento HTML
RT_ICON Recurso ícone hardware-dependente
RT_MENU Recurso de menu
RT_MESSAGETABLE Mensagem-entrada tabela
RT_RCDATA Recurso Application-defined (dados brutos)
RT_STRING Cadeia de caracteres-entrada tabela
RT_VERSION Versão do recurso

lpName
Ponteiro para uma seqüência de caracteres null-terminated especificando o nome do recurso para ser atualizado. Este parâmetro também pode ser um número inteiro valor passado para o MAKEINTRESOURCE macro.
wLanguage
Especifica o identificador de idioma do recurso para ser atualizado. Para obter uma lista dos identificadores de idioma primário e identificadores de sublinguagem que compõem um identificador de idioma, consulte o MAKELANGID macro.
lpData
Ponteiro para os dados de recurso a ser inserido para o arquivo executável. Se o recurso for um dos tipos predefinidos, os dados devem ser válidos e corretamente alinhados. Note que este é processado dados binários armazenados no arquivo executável, não os dados fornecidos pela LoadIcon, LoadStringou outras funções específicas de recurso de carga. Todos os dados que contém seqüências de caracteres ou texto devem estar no formato Unicode; lpData não deve apontar para dados ANSI.

Se lpData é NULL, o recurso especificado é excluído do arquivo executável.

cbData
Especifica o tamanho, em bytes, de dados recurso no lpData.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Um aplicativo pode usar UpdateResource repetidamente para alterar os dados do recurso. Cada chamada para UpdateResource contribui para uma lista interna de adições, exclusões e substituições, mas na verdade não gravar os dados para o arquivo executável. O aplicativo deve usar a função EndUpdateResource para gravar as mudanças acumuladas para o arquivo executável.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Sem suporte.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinBase. h.
Biblioteca de importação:Use Kernel32. lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral sobre recursos, recurso funciona, BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index