RMDestroySysName

This rmcall service destroys a system name handle that was created by RMCreateSysName.

Syntax

RMDestroySysName(hDriver, hSysName);

Parameters

hDriver (HDRIVER) - input 

Driver handle of the device driver that created the logical device.

hSysName (HSYSNAME) - input 

Handle of the system name to be destroyed.

Return Code

rc (APIRET) - returns 

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

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_DRIVERHANDLE 

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_BAD_DEVICEHANDLE 

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.

Remarks

None.

Example Code

C

#include <os.2>
#include <rmcalls.h>

HDRIVER     hDriver;
HSYSNAME    hSysName;
APIRET      rc;

rc = RMDestroySysName(hDriver, hSysName);