Метод IResourceList::FindTranslatedEntry (portcls.h)

Статья
08/07/2023

Метод FindTranslatedEntry возвращает указатель на переведенную запись указанного типа или значение NULL , если такая запись не найдена.

Синтаксис

PCM_PARTIAL_RESOURCE_DESCRIPTOR FindTranslatedEntry(
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

Параметры

[in] Type

Определяет тип ресурса записи для поиска. Список допустимых значений типа ресурса см. в элементе Type структуры CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Указывает индекс искать запись. Если метод IResourceList::NumberOfEntriesOfType возвращает значение n для количества записей типа Type, допустимые индексы варьируются от 0 до n–1. Например, если аргумент Index равен нулю, метод возвращает указатель на переведенную версию первого вхождения записи указанного типа из списка ресурсов.

Возвращаемое значение

FindTranslatedEntry возвращает указатель на указанную запись или имеет значение NULL , если запись не существует. Этот указатель остается действительным до удаления объекта списка ресурсов.

Параметр Index указывает, какое вхождение записи указанного типа следует найти в списке переведенных записей ресурсов. Первое вхождение в списке имеет нулевой индекс.

Для каждого типа ресурса определен макрос для вызова этого метода. См. раздел IResourceList.

Дополнительные сведения о переведенных и непереводимых (или "необработанных") ресурсах см. в разделе CM_PARTIAL_RESOURCE_DESCRIPTOR.