Directional Attributes Applied to the Parameter

The directional attributes [ in] and [ out] determine how the client and server allocate and free memory. The following table summarizes the effect of directional attributes on memory allocation.

Directional attribute	Memory on client	Memory on server
[ in]	Client application must allocate before the call.	Server stub allocates.
[ out]	Client stub allocates on return.	Server stub allocates top-level pointer only; the server application must allocate all embedded pointers. The server also allocates new data as needed.
[in, out]	Client application must allocate initial data transmitted to server; client stub allocates additional data.	Server stub allocates initial data transmitted from client; the server application allocates new data as needed.

 

In all of these cases the client stub does not free memory. The client application must free the memory before it terminates. The server stub frees memory when the remote procedure call returns (subject to the [ allocate] ACF attribute).