CONFIGMG_Get_Next_Res_Des

CONFIGRET CONFIGMG_Get_Next_Res_Des(PRES_DES prdResDes, RES_DES rdResDes, RESOURCEID ForResource, PRESOURCEID pResourceID, ULONG ulFlags)

Retrieves the handle of the next resource descriptor in a logical configuration.

• Returns CR_SUCCESS if the function is successful. Otherwise, the return value can be CR_INVALID_FLAG, CR_INVALID_POINTER, CR_INVALID_LOG_CONF, CR_INVALID_RES_DES or CR_NO_MORE_RES_DES.

prdResDes

Address that receives the handle of the next resource descriptor.

rdResDes

Handle of the current resource descriptor or the handle of a logical configuration. (Both are 32-bit numbers; Configuration Manager can distinguish between them.)

ForResource

One of the resource identifiers listed in the ResourceId parameter of the CONFIGMG_Add_Res_Des function, or ResType_All. If this parameter is ResType_All, the function returns the handle of the next resource descriptor, no matter what its type. Otherwise, the function retrieves the handle of the first resource descriptor of the specified type.

pResourceID

Address that receives the resource type, when ForResource specifies ResType_All. (When ForResource is not ResType_All, this parameter can be NULL.)

ulFlags

Must be zero.

See also CONFIGMG_Get_Res_Des_Data, CONFIGMG_Get_Res_Des_Data_Size