RMGetCommandLine

This rmcall service returns the command line that corresponds to the specified driver name.

Syntax

RMGetCommandLine(ConfigFileSpec, ConfigParms, ConfigParmsLen, Index, DDType);

Parameters

ConfigFileSpec (PSZ) - input 

The file name found in config.sys.

ConfigParms (PSZ) - output 

Pointer to the variable to receive the returned detected device handle.

ConfigParmsLen (PUSHORT) - output 

The length of the command line parameter. If the length is not large enough, Resource Manager will return the required length.

Index (USHORT) - input 

Indicates the occurrence in the config.sys file that matches the ConfigFileSpec name. A device driver may be found more than once in the config.sys. If the Index value equals zero, the first match found is returned.

DDType (USHORT) - input 

Indicates whether to search the "basedd=" list or the "device=". list

RM_CMD_BASE 

"basedd="

RM_CMD_DEVICE 

"device="

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_BUFFER_TOO_SMALL
   RMRC_INVALID_PARM_VALUE
   RMRC_NULL_POINTER
   RMRC_SEARCH_FAILED
   RMRC_SUCCESS

Example Code

C

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

PSZ        ConfigFileSpec;
PSZ        ConfigParms;
PUSHORT    ConfigParmsLen;
USHORT     Index;
USHORT     DDType;
APIRET     rc;

rc = RMGetCommandLine(ConfigFileSpec, ConfigParms,
       ConfigParmsLen, Index, DDType);