Metodo IResourceList::AddEntryFromParent (portcls.h)

Articolo
02/07/2025

Il metodo AddEntryFromParent aggiunge a un elenco di risorse una voce presente nell'elenco padre dell'elenco di risorse.

Sintassi

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

Parametri

[in] Parent

Puntatore al padre IResourceList oggetto da cui eseguire la voce.

[in] Type

Identifica il tipo di risorsa della voce da aggiungere. Per un elenco di valori validi di tipo risorsa, vedere la descrizione del membro type della struttura di CM_PARTIAL_RESOURCE_DESCRIPTOR.

[in] Index

Specifica l'indice nell'elenco padre della voce da aggiungere. Se il metodo IResourceList::NumberOfEntriesOf Type dell'elemento padre restituisce un valore n per il numero di voci di tipo Type, gli indici validi vanno da 0 a n-1. Se Index è zero, ad esempio, il metodo aggiunge la prima occorrenza di una voce del tipo specificato dall'elenco padre.

Valore restituito

AddEntryFromParent restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. La tabella seguente illustra alcuni dei possibili codici di stato restituiti.

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Indica che nell'elenco non sono presenti voci gratuite.
STATUS_INVALID_PARAMETER	Indica che la voce non è stata trovata nell'elenco padre.

Osservazioni

Per ogni tipo di risorsa, viene definita una macro per chiamare questo metodo. Vedere IResourceList.

Il parametro parent segue le convenzioni di conteggio dei riferimenti per gli oggetti COM.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL

Vedere anche

CM_PARTIAL_RESOURCE_DESCRIPTOR

IResourceList

IResourceList::NumberOfEntriesOfType

Condividi tramite