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

Метод AddEntryFromParent добавляет в список ресурсов запись, найденную в родительском списке списка ресурсов.

Синтаксис

NTSTATUS AddEntryFromParent(
  [in] IResourceList    *Parent,
  [in] CM_RESOURCE_TYPE Type,
  [in] ULONG            Index
);

Параметры

[in] Parent

Указатель на родительский объект IResourceList , из которого требуется выполнить запись.

[in] Type

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

[in] Index

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

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

AddEntryFromParent возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки. В следующей таблице показаны некоторые возможные коды состояния возврата.

Код возврата Описание
СТАТУС_НЕДОСТАТОЧНЫЕ_РЕСУРСЫ
 Указывает, что в списке нет бесплатных записей.
СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР
 Указывает, что запись не найдена в родительском списке.

Замечания

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

Родительский параметр следует соглашениям о подсчете ссылок для com-объектов.

Требования

Требование Ценность
целевая платформа универсальный
Заголовок portcls.h (include Portcls.h)
IRQL пассивный уровень

См. также

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType

  • Last updated on