NWDPLibCalloc

Allocates memory and sets memory to zero

Local Servers: nonblocking

Remote Servers: N/A

NetWare Server: 4.11, 5.x

Platform: NLM, Windows 95, Windows 98

Service: Distributed Print

Syntax

#include <nwdp_lib.h>  
  
N_EXTERN_LIBRARY (NWDPInitCode) NWDPLibCalloc  (  
   NWDPAccessorRef   accessorRef,   
   pnptr             resultMemPtr,   
   nint              numElements,   
   nint              szMem);

Parameters

accessorRef

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

resultMemPtr

(OUT) Points to a pointer which will receive the newly allocated memory's address.

numElements

(IN) Specifies a number of array elements.

szMem

(IN) Specifies the amount of memory needed for each array element.

Return Values

0x00000000	N_SUCCESS
0x030A0001	NWDP_EC_NO_MEMORY
0x030A0009	NWDP_EC_ARTIFICIAL_MEM_LIMIT
0xFFFFFFFE	NWDP_RC_INVALID_ACCESSOR
0xFFFFFFFF	N_FAILURE

Remarks

NWDPLibCalloc is not recommended except for applications which must use this library.

NWDPLibCalloc can block if the server has to wait for allocation.

Any memory allocated by NWDPLibCalloc is automatically freed when NWDPLibTerm is called.

The size of memory allocated is (numElement*szMem).

NWDPLibCalloc is equivalent to calloc from the C run-time library except for error handling.

The errors NWDP_EC_NO_MEMORY and NWDP_EC_ARTIFICIAL_MEM_LIMIT both return the following information:

The otherError field of the accessorRef will contain the size of the request made of the system ( szMem), and the otherError2 field of the accessorRef will contain the current memory allocation total made through NWDPLibxxxx entry points.