RMGetNodeInfo

This service is supported by both rminfo.dll and rmcalls.lib. It returns Resource Manager node information.

Syntax

RMGetNodeInfo(hRMHandle, NodeInfo, NodeInfoSize);

Parameters

hRMHandle (RMHANDLE) - output

Resource Manager handle whose information is to be returned. The following handle types are allowed:

   ³HandleType                    ³Description                   ³
   ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
   ³HANDLE_TYPE_DRIVER            ³Driver Handle                 ³
   ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
   ³HANDLE_TYPE_ADAPTER           ³Adapter Handle                ³
   ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
   ³HANDLE_TYPE_DEVICE            ³Device Handle                 ³
   ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
   ³HANDLE_TYPE_LOGDEV            ³Logical Device Handle         ³
   ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
   ³HANDLE_TYPE_SYSDEV            ³System Name Handle            ³

NodeInfo (PRM_GETNODE_DATA) - output

Pointer to a buffer that will contain the Resource Manager node information in the RM_GETNODE_DATA, RM_NODE, and RESOURCELIST data structures.

NodeInfoSize (USHORT) - input

Size of buffer pointed to by NodeInfo.

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_BAD_ADAPTERHANDLE

The expected Resource Manager handles were not provided because the handle was not a valid Resource Manager handle or the handle did not point to the type of object the service required.

RMRC_BUFFER_TOO_SMALL

The buffer provided to receive information from a Resource Manager service was too small.

Remarks

None.

Example Code

C

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

RMHANDLE            hRMHandle;
PRM_GETNODE_DATA    NodeInfo;
USHORT              NodeInfoSize;
APIRET              rc;

rc = RMGetNodeInfo(hRMHandle, NodeInfo, NodeInfoSize);