RMResToHandleList

This rmcall service returns a list of Adapter/Device handles that own the resource indicated.

Syntax

RMResToHandleList(ResStruct, HandleList);

Parameters

ResStruct (PRESOURCESTRUCT) - output

Pointer to a RESOURCESTRUCT whose owners are to be located. Refer to RMAllocResource for a description of the RESOURCESTRUCT datatype.

HandleList (PHANDLELIST) - output

Structure containing a list of adapter or device handles that include the specified resource. Refer to RMKeyToHandleList for a description of the HANDLELIST datatype.

Return Code

rc (APIRET) - returns

On systems where the Resource Manager driver is not installed, the library interface code will return RMRC_NOT_INSTALLED.

RMRC_IRQ_ENTRY_ILLEGAL

A Resource Manager service was issued at interrupt time. The Resource Manager service request can be issued only at task time or INIT time.

RMRC_NULL_POINTER

A Resource Manager service received a NULL value for a pointer that was expected to contain a valid 16:16 address.

RMRC_INVALID_PARM_VALUE

A nonhandle or nonpointer variable contains an invalid or out-of-range value because:

• An invalid decode width was specified when allocating an I/O Port range.
• A handle search is being performed with cMaxHandles set to 0.

Remarks

None.

Example Code

C

#include <os2.h>
#include <rmcalls.h>

PRESOURCESTRUCT    ResStruct;
PHANDLELIST        HandleList;
APIRET             rc;

rc = RMResToHandleList(ResStruct, HandleList);