PrlHndlList_GetItemsCount Function

Determines the total number of handles in the specified container.

Syntax

PRL_RESULT PrlHndlList_GetItemsCount(
    PRL_HANDLE hHandlesList, 
    PRL_UINT32_PTR pnItemsCount
);

hHandlesList

A handle of type PHT_HANDLES_LIST identifying the container.

pnItemsCount

[out] A pointer to a variable that receives the result. Handle count begins with zero.

PRL_RESULT . Possible values are:

PRL_ERR_INVALID_ARG - invalid handle or out of range index value was passed.

PRL_ERR_SUCCESS - operation completed successfully.

After determining the count, use the PrlHndlList_GetItem function to retrieve the handle from the container.