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).
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
