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.

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:

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