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