NWDPResDeleteResourceFile

Deletes a resource file in the Resource Management Servie (RMS) data area

Local Servers: blocking
Remote Servers: blocking
NetWare Server: 4.11, 5.x
Platform: NLM, Windows 95, Windows 98
Service: Distributed Print


Syntax

#include <nwdp_res.h>  

N_EXTERN_LIBRARY (nint) NWDPResDeleteResourceFile (
NWDPAccessorRef accessorRef,
NWDPResRef resRef,
NWDPResourceTypeEnum resType,
nparam deleteInput);


Parameters

accessorRef

(IN) Specifies the NWDPAccessorData structure whose fields are accessed by using the provided error macros.


resRef

(IN) Specifies the reference to the resource manager.


resType

(IN) Specifies the resource type.


deleteInput

(IN) Specifies the type of input needed to delete, based on the resType parameter value.


Return Values

0x00000000

N_SUCCESS

0xFFFFFFFE

NWDP_RC_INVALID_ACCESSOR

0xFFFFFFFF

N_FAILURE


Remarks

For the resRef parameter, the following functions generate a resource reference:

NWDPResCreateRefBasedOnAddr
NWDPResCreateRefBasedOnFQN
NWDPResCreateRefBasedOnSrsSAP

For the resType parameter, the resource types are as follows:

NWDP_RES_PRN_DRV
NWDP_RES_PRN_DEF
NWDP_RES_BANNER_PAGE
NWDP_RES_FONT

The current implementation of NWDPResDeleteResourceFile does not delete all files referenced by an index file (.inf or .ndx).

If the accessorRef parameter returns NWDP_EC_RESMAN_RESULT, the otherError field in the accessorRef parameter contains an error code from the Resource Manager. This error code correlates to the enumeration values found in the nwdp_err.h file.

The deleteInput parameter value is based on the following resType parameter value:

resType deleteInput

NWDP_RES_PRN_DRV

Points to the NWDPResDeletePrnDrvFile structure

NWDP_RES_PRN_DEF

Points to the NWDPResDeletePrnDefFile structure

NWDP_RES_BANNER_PAGE

Points to Unicode string (pnstr16) containing a banner page filename

NWDP_RES_FONT

Points to the NWDPResDeleteFontFile structure

If NWDPResDeleteResourceFile returns N_FAILURE, NWDPLibErrorMac (accessorRef) contains the following:

0x01000004L NWDP_EC_STDIO
0x01100001L NWDP_EC_RESMAN_RESULT


See Also

NWDPResAddResourceFile (obsolete 9/98)
NWDPResCreateRefBasedOnAddr
NWDPResCreateRefBasedOnFQN
NWDPResCreateRefBasedOnSrsSAP