FindResource

Функція FindResource визначає розташування ресурс з вказано тип та ім'я у вказаний модуль.

(HRSRC FindResource HMODULE  hModule, / / модуль обробкиLPCTSTRlpName, / / вказівник на ім'я ресурсуLPCTSTRlpType / / тип вказівника на ресурс);
 

Параметри

hModule
Обробляти модуля, чиї виконуваний файл містить ресурс.

Значення NULL вказує маркер модуля, зв'язаної з файлом зображення, що операційна система, що використовується для створення поточного процесу.

lpName
Визначає ім'я ресурсу. Щоб отримати додаткові відомості перегляньте розділ зауваження.
lpType
Визначає тип ресурсів. Щоб отримати додаткові відомості перегляньте розділ зауваження. Для стандартного ресурсів типів цей параметр може бути одне з таких значень:
Значення Значення
RT_ACCELERATOR Прискорювач таблиці
RT_ANICURSOR Анімований вказівник
RT_ANIICON Анімовані значок
RT_BITMAP Растрові ресурс
RT_CURSOR Апаратно залежні курсор ресурс
RT_DIALOG Діалогове вікно
RT_FONT Шрифт ресурс
RT_FONTDIR Шрифт Каталог ресурсів
RT_GROUP_CURSOR Апаратно незалежний курсор ресурс
RT_GROUP_ICON Апаратно незалежний значок ресурс
RT_HTML HTML-документ
RT_ICON Апаратно залежні значок ресурс
RT_MENU Меню ресурс
RT_MESSAGETABLE Повідомлення покажчика
RT_RCDATA Визначений у застосунку ресурсу (необроблені дані)
RT_STRING Запис таблиці рядків
RT_VERSION Версія ресурс

Повернення значень

Якщо функція завершено успішно, значення, що повертається є маркер, щоб заблокувати вказаний ресурс інформації. Отримати ручку на ресурс, передавати цей маркер LoadResource функції.

Якщо функцію не вдається, значення, що повертається, є NULL. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

Якщо слово вищого порядку lpName або lpType параметр дорівнює нулю, Низька замовлення слово вказує ціле число ідентифікатор імені або типу даного ресурсу. В іншому випадку, ці параметри є довгий вказівники нульовим рядків. Якщо перший символ рядок діезу (#), Решта знаків представляє десяткове число, яке вказує ціле число ідентифікатор ресурсів імені або типу. Наприклад, рядок "№ 258" представляє ціле число ідентифікатор 258.

Програма має зменшити обсяг пам'яті, що необхідні для ресурсів, посилаючись на їх на ціле число ідентифікатор замість за іменем.

Коли ви закінчите з використанням до таблиці прискорювача, точковий рисунок, курсор, значок або меню, ви можете звільнити свого пов'язаних пам'яті за номером один функцій в таблиці.

Ресурс Реліз функції
Прискорювач таблиці DestroyAcceleratorTable
Крапковий малюнок Видалити за допомогою
Курсор DestroyCursor
Значок DestroyIcon
Меню DestroyMenu

Система автоматично видалить ці ресурси, коли завершується процес, який створив їх, однак, виклику відповідні функції заощаджує пам'ять і зменшує розмір цей процес робоча множина.

Заявку можна використовувати FindResource , щоб знайти будь-який тип ресурсу, але цю функцію слід використовувати, лише якщо додаток має доступ до даних двійкові ресурс, при прийнятті подальших дзвінки на LoadLibrary і LockResource.

Використовувати ресурс негайно, додаток слід використовувати один з таких ресурсів специфічні функції знайти і завантажити ресурси в одному виклику:

Функція Дія
FormatMessage Навантажень і формати покажчика повідомлення.
LoadAccelerators Завантажує таблиці прискорювача.
LoadBitmap Завантажує бітових ресурс.
LoadCursor Завантажує курсор ресурс.
LoadIcon Навантаження на значок ресурс.
LoadMenu Завантажує меню ресурс.
LoadString Завантажує запис таблиці рядків.

Наприклад, програма може використовувати функцію LoadIcon завантажити значок для відображення на екрані. Однак, застосування повинні використовувати FindResource і LoadResource , якщо він завантажується на значок, щоб скопіювати дані до іншої програми.

Рядок ресурсів зберігаються в розділах 16 рядків в розділі. Рядки кожного розділу зберігаються як послідовність підрахованих рядків Юнікод (не нульовим). На LoadString функція буде отримати рядкового ресурсу з відповідного розділу.

Windows CE: HModule параметр не може бути дескриптор NULL.

LpName параметр не підтримує ресурс ID нуль — тобто, FindResource (h, 0, t) не буде працювати належним чином.

Не вдалося передати значення RT_ANICURSOR або RT_ANIICON в параметрі lpType .

QuickInfo

nbsp; Windows &NT: вимагає 3.1 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winbase.h.
Імпортувати бібліотеки:Використання kernel32.lib.
Юнікод:Реалізований у вигляді Юнікод і ANSI версії Windows і Windows NT.

Дивіться також

Огляд ресурсів, ресурс функції, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index