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

Artigo
02/29/2024

O AddEntryFromParent método adiciona a uma lista de recursos uma entrada encontrada na lista pai da lista de recursos.

Sintaxe

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

Parâmetros

[in] Parent

Ponteiro para o objeto IResourceList pai do qual a entrada deve ser obtida.

[in] Type

Identifica o tipo de recurso da entrada que deve ser adicionada. Para obter uma lista de valores válidos do tipo de recurso, consulte a descrição do membro Type da estrutura CM_PARTIAL_RESOURCE_DESCRIPTOR .

[in] Index

Especifica o índice na lista pai da entrada a ser adicionada. Se o método IResourceList::NumberOfEntriesOfType do pai retornar um valor n para o número de entradas do tipo Type, os índices válidos variam de 0 a n-1. Se Index for zero, por exemplo, o método adicionará a primeira ocorrência de uma entrada do tipo especificado da lista pai.

Retornar valor

AddEntryFromParent retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro apropriado. A tabela a seguir mostra alguns dos possíveis códigos de status de retorno.

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	Indica que não há entradas gratuitas na lista.
STATUS_INVALID_PARAMETER	Indica que a entrada não foi encontrada na lista pai.