Поделиться через


Метод 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. Например, если значение Index равно нулю, метод добавляет первое вхождение записи указанного типа из родительского списка.

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

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

Код возврата Описание
STATUS_INSUFFICIENT_RESOURCES
Указывает, что в списке нет свободных записей.
STATUS_INVALID_PARAMETER
Указывает, что запись не найдена в родительском списке.

Комментарии

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

Параметр Parent соответствует соглашениям о подсчете ссылок для COM-объектов.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
IRQL PASSIVE_LEVEL

См. также раздел

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType