Allocates memory
#include <nwdp_lib.h>
N_EXTERN_LIBRARY (NWDPInitCode) NWDPLibMalloc (
NWDPAccessorRef accessorRef,
pnptr resultMemPtr,
nint szMem);
(IN) Specifies the NWDPAccessorData structure whose fields are accessed by using the provided error macros.
(OUT) Points to a pointer which will receive the newly allocated memory's address.
(IN) Specifies the size of memory to allocate.
0x00000000 |
N_SUCCESS |
0x030A0001 |
NWDP_EC_NO_MEMORY |
0x030A0009 |
NWDP_EC_ARTIFICIAL_MEM_LIMIT |
0xFFFFFFFE |
NWDP_RC_INVALID_ACCESSOR |
0xFFFFFFFF |
N_FAILURE |
NWDPLibMalloc is not recommended except for applications which must use this library.
NWDPLibMalloc can block if the server has to wait for allocation.
Any memory allocated by NWDPLibMalloc is automatically freed when NWDPLibTerm is called.
NWDPLibMalloc is equivalent to malloc 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 point.