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

Artículo
02/29/2024

El AddEntryFromParent método agrega a una lista de recursos una entrada que se encuentra en la lista primaria de la lista de recursos.

Sintaxis

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

Parámetros

[in] Parent

Puntero al objeto IResourceList primario desde el que se va a tomar la entrada.

[in] Type

Identifica el tipo de recurso de la entrada que se va a agregar. Para obtener una lista de valores válidos de tipo de recurso, vea la descripción del miembro Type de la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Especifica el índice de la lista primaria de la entrada que se va a agregar. Si el método IResourceList::NumberOfEntriesOfType del elemento primario devuelve un valor n para el número de entradas de tipo Type, los índices válidos van de 0 a n-1. Si Index es cero, por ejemplo, el método agrega la primera aparición de una entrada del tipo especificado de la lista primaria.

Valor devuelto

AddEntryFromParent devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado. En la tabla siguiente se muestran algunos de los posibles códigos de estado de retorno.

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	Indica que no hay entradas gratuitas en la lista.
STATUS_INVALID_PARAMETER	Indica que no se encontró la entrada en la lista primaria.