FindResourceEx

A função FindResourceEx determina o local do recurso com o tipo especificado, o nome e o idioma no módulo especificado.

(HRSRC FindResourceEx HMODULE  hModule, / / módulo de recurso identificadorLPCTSTRlpType, / / ponteiro para recurso tipoLPCTSTRlpName, / / ponteiro para nome do recursoPalavrawLanguage / / idioma de recurso ) 

Parâmetros

hModule
Identificador para o módulo cujo arquivo executável contém o recurso. Se este parâmetro é NULL, a função procura o módulo usado para criar o atual processo.
lpType
Ponteiro para uma seqüência de caracteres null-terminated especificando o nome do tipo do recurso. Para obter mais informações, consulte a seção comentários. Para tipos de recurso padrão, este parâmetro pode ser uma dos seguinte valores:
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 obter mais informações, consulte a seção Comentários.
wLanguage
Especifica o idioma do recurso. Se este parâmetro for MAKELANGID (LANG_NEUTRAL, SUBLANG_PORTUGUESE), o idioma atual associado com o thread de chamada é usado.

Para especificar um idioma diferente do idioma atual, use o MAKELANGID macro para criar esse parâmetro. Para obter mais informações, consulte MAKELANGID.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador para bloco de info do recurso especificado. Para obter um identificador para o recurso, passar esse identificador para o LoadResource função.

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

Observações

Se o alto-palavra do lpType ou lpName parâmetro é zero, a baixa-palavra Especifica o identificador inteiro do tipo ou nome de determinado recurso. Caso contrário, esses parâmetros são ponteiros para seqüências de caracteres terminada por caractere nulo. Se o primeiro caractere da seqüência de caracteres é um sinal de libra (#), os caracteres restantes representam um decimal número que especifica o identificador inteiro do nome ou o tipo do recurso. Por exemplo, a Cadeia de caracteres "# 258" representa o identificador inteiro 258.

Aplicativos devem reduzir a quantidade de memória necessária para os recursos, referindo-se a eles pelo identificador inteiro em vez de por nome.

Quando você tiver terminado usando uma tabela de teclas aceleradoras, bitmap, cursor, ícone ou menu, você pode liberar seu associado memória por chamado um das funções na tabela a seguir.

Recurso Função de lançamento
Tabela de teclas aceleradoras DestroyAcceleratorTable
Bitmap ExcluirObjeto
Cursor DestroyCursor
Ícone DestroyIcon
Menu DestroyMenu

O sistema exclui automaticamente esses recursos quando termina o processo que criado-los, no entanto, chamado de apropriado função salva memória e diminui o tamanho do conjunto de trabalho do processo.

Um aplicativo pode usar FindResourceEx para encontrar qualquer tipo de recurso, mas esta função deve ser usada somente se o aplicativo deve acessar o binário dados recurso ao fazer chamadas subseqüentes para o funções LoadLibrary e LockResource.

Para usar um recurso imediatamente, um aplicativo deve usar as seguintes funções resource-specific para localizar e carregar os recursos em uma chamada:

Função Ação
FormatMessage Carrega e formata uma mensagem entrada tabela.
LoadAccelerators Carrega uma tabela de teclas aceleradoras.
LoadBitmap Carrega um recurso de bitmap.
LoadCursor Carrega um recurso cursor.
LoadIcon Carrega um recurso de ícone.
LoadMenu Carrega um recurso de menu.
LoadString Carrega uma seqüência de caracteres-entrada tabela.

Por exemplo, um aplicativo pode usar o LoadIcon função para carregar um ícone para exibir na tela. No entanto, o aplicativo deve usar FindResourceEx e LoadResource se ele está carregando no ícone para copiar seus dados para outro aplicativo.

Recursos de Cadeia de caracteres são armazenados nas seções de até 16 cordas por seção. As seqüências de caracteres em cada seção são armazenadas como uma seqüência de contados seqüências Unicode (não null-terminated). O LoadString função irá extrair o recurso de Cadeia de caracteres de sua seção correspondente.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
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 e Windows NT.

Ver também

Visão geral sobre recursos, recurso funções, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon LoadMenu, LoadString, LoadResource, MAKELANGID

Index