Méthode IResourceList ::AddEntryFromParent (portcls.h)

Article
02/29/2024

La AddEntryFromParent méthode ajoute à une liste de ressources une entrée trouvée dans la liste parente de la liste de ressources.

Syntaxe

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

Paramètres

[in] Parent

Pointeur vers l’objet IResourceList parent à partir duquel l’entrée doit être extraite.

[in] Type

Identifie le type de ressource de l’entrée à ajouter. Pour obtenir la liste des valeurs de type ressource valides, consultez la description du membre Type de la structure CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Spécifie l’index dans la liste parente de l’entrée à ajouter. Si la méthode IResourceList ::NumberOfEntriesOfType du parent retourne une valeur n pour le nombre d’entrées de type Type, les index valides vont de 0 à n-1. Si Index est égal à zéro, par exemple, la méthode ajoute la première occurrence d’une entrée du type spécifié à partir de la liste parente.

Valeur retournée

AddEntryFromParent retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié. Le tableau suivant présente certains des codes de retour possibles status.

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	Indique qu’il n’y a aucune entrée libre dans la liste.
STATUS_INVALID_PARAMETER	Indique que l’entrée est introuvable dans la liste parente.