IResourceList::AddEntryFromParent-Methode (portcls.h)

Artikel
03/01/2024

Die AddEntryFromParent -Methode fügt einer Ressourcenliste einen Eintrag in der übergeordneten Liste der Ressourcenliste hinzu.

Syntax

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

Parameter

[in] Parent

Zeiger auf das übergeordnete IResourceList-Objekt , von dem der Eintrag übernommen werden soll.

[in] Type

Gibt den Ressourcentyp des hinzuzufügenden Eintrags an. Eine Liste der gültigen Ressourcentypwerte finden Sie in der Beschreibung des Typmembers der CM_PARTIAL_RESOURCE_DESCRIPTOR-Struktur .

[in] Index

Gibt den Index in der übergeordneten Liste des hinzuzufügenden Eintrags an. Wenn die IResourceList::NumberOfEntriesOfType-Methode des übergeordneten Elements den Wert n für die Anzahl der Einträge vom Typ Type zurückgibt, reichen gültige Indizes von 0 bis n-1. Wenn Index beispielsweise null ist, fügt die Methode das erste Vorkommen eines Eintrags des angegebenen Typs aus der übergeordneten Liste hinzu.

Rückgabewert

AddEntryFromParent gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. In der folgenden Tabelle sind einige der möglichen Rückgabecodes status aufgeführt.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Gibt an, dass in der Liste keine freien Einträge vorhanden sind.
STATUS_INVALID_PARAMETER	Gibt an, dass der Eintrag in der übergeordneten Liste nicht gefunden wurde.