RMResToHandleList
From EDM2
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);