DmiPoolAlloc(3dmi)


DmiPoolAlloc -- allocate a memory block in a pool

Synopsis

#include <dmi2mem.h>

Void * DMI_API DmiPoolAlloc ( size_t size; void * pool_handle; Dmi_ErrorStatus_t * status; );

Description

DmiPoolAlloc is used to allocate size-byte memory in a pool of memory previously created by DmiCreatePool(3dmi). When successful, it returns a pointer to the allocated block, otherwise it returns NULL.

Parameters


size
(input) Memory block size

pool_handle
Pool handle created by DmiCreatePool(3dmi).

status
Pointer to an address in memory where the DmiErrorStatus_t code is returned or NULL.

Return values

This function returns the pointer to the allocated block or NULL in case of failure.

The status returned is one of:

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004