Metodo IResourceList::AddEntryFromParent (portcls.h)

Articolo
02/29/2024

Il AddEntryFromParent metodo aggiunge a un elenco di risorse una voce trovata 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 all'oggetto IResourceList padre da cui deve essere presa la voce.

[in] Type

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

[in] Index

Specifica l'indice nell'elenco padre della voce da aggiungere. Se il metodo IResourceList::NumberOfEntriesOfType restituisce un valore n per il numero di voci di tipo Type, gli indici validi sono compresi tra 0 e 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 esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. La tabella seguente mostra alcuni dei possibili codici di stato restituiti.

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