IResourceList::AddEntryFromParent 方法 (portcls.h)
方法 AddEntryFromParent
向资源列表添加在资源列表的父列表中找到的条目。
语法
NTSTATUS AddEntryFromParent(
[in] IResourceList *Parent,
[in] CM_RESOURCE_TYPE Type,
[in] ULONG Index
);
参数
[in] Parent
指向要从中获取条目的父 IResourceList 对象的指针。
[in] Type
标识要添加的条目的资源类型。 有关有效资源类型值的列表,请参阅 CM_PARTIAL_RESOURCE_DESCRIPTOR 结构的 Type 成员的说明。
[in] Index
指定要添加的项的父列表中的索引。 如果父级的 IResourceList::NumberOfEntriesOfType 方法返回类型类型条目数的值 n,则有效索引范围为 0 到 n-1。 例如,如果 Index 为零,则方法从父列表中添加指定类型的条目的第一个匹配项。
返回值
AddEntryFromParent
如果调用成功,则返回STATUS_SUCCESS。 否则,该方法将返回相应的错误代码。 下表显示了一些可能的返回状态代码。
返回代码 | 说明 |
---|---|
|
指示列表中没有可用条目。 |
|
指示在父列表中找不到该条目。 |
注解
对于每个资源类型,定义了一个宏来调用此方法。 请参阅 IResourceList。
Parent 参数遵循 COM 对象的引用计数约定。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | portcls.h (包括 Portcls.h) |
IRQL | PASSIVE_LEVEL |