FindResource

A FindResource função determina a localização de um recurso com o tipo especificado e o nome do módulo especificado.

(HRSRC FindResource HMODULE  hModule, / / módulo de lidar comLPCTSTRlpName, / / ponteiro para nome do recursoLPCTSTRlpType / / ponteiro para recurso tipo);
 

Parâmetros

hModule
Identificador para o módulo cujo arquivo executável contém o recurso.

Um valor de NULL especifica o identificador do módulo associado com o arquivo de imagem que o sistema operacional usado para criar o atual processo.

lpName
Especifica o nome do recurso. Para obter mais informações, consulte a seção Comentários.
lpType
Especifica o tipo de 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

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 ordem do lpName ou lpType parâmetro é zero, a baixa palavra ordem Especifica o identificador inteiro do nome ou tipo de determinado recurso. Caso contrário, esses parâmetros são longos 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.

Um aplicativo deve 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 FindResource para localizar 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 LoadLibrary e LockResource.

Para usar um recurso imediatamente, um aplicativo deve usar uma das 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 FindResource 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.

Windows CE: O hModule parâmetro não pode ser um identificador NULL.

O parâmetro lpName não suporta a identificação de recurso zero — ou seja, FindResource (h, 0, t) não funciona como esperado.

Você não pode passar os valores de RT_ANICURSOR ou RT_ANIICON no lpType parâmetro.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
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 funciona, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index