(a) TP1/Client/W

 
#include <dcvxatmi.h>
char *tpalloc(char *type, char *subtype, DCLONG size)
 

(b) TP1/Client/P

 
#include <dcvxatmi.h>
char CLTFAR *tpalloc(char CLTFAR *type, 
      char CLTFAR *subtype, DCLONG size)
 

Allocates the typed buffer.

Some types of buffer must be initialized before use. The tpalloc function initializes the buffer after the buffer is allocated until it returns. The buffer is returned to the issuer of the tpalloc function when issuance of a function becomes available.

Define the method of initialization by communication resource managers for TP1/Client and TP1/Server Base. If not defined, the tpalloc function does not initialize the buffer.

When the initialization completes successfully, the tpalloc function returns a pointer to a buffer of the appropriate type aligned on a long word. The function returns NULL if an error occurs; error information is returned as the return value. If initialization failed, the allocated buffer is released and NULL is returned.

• type
  Specify X_OCTET as the buffer type.
  
• subtype
  Specify NULL as the buffer subtype.
  
• size
  Specify the size of the buffer to be allocated.
  

When the initialization completes successfully, the tpalloc function returns a pointer to a buffer of the appropriate type aligned on a long word. If an error occurs, the function returns NULL and sets one of the following values in tperrno as a return value to report the information about the error.

Return value	Meaning
TPEINVAL	Invalid argument
TPENOENT	The value specified in the argument is not defined in the system.
TPEPROTO	Inappropriate status for issuing the tpalloc function.
TPESYSTEM	An error occurred in the communication resource manager.
TPEOS	An error occurred in the operating system.

• The tpalloc function cannot be used with any of these C functions: malloc, realloc, or free.
  

  Example:

  The buffer allocated by the tpalloc function cannot be released by the free function.

  Operation of the system is not guaranteed when above functions are used together.
  
• The buffer returned by the tpalloc function is initialized to zero.
• The buffer area is acquired from the global heap.
• When TPESYSTEM is returned for an error in TP1/Client, error information is output to the error log.
• When TPEOS is returned, insufficient memory is suspected as the cause. Error information is output to the error log when the error occurred in TP1/Client.