CM ALLOCDETAILFIELDINFO

This message allocates memory for one or more FIELDINFO structures.

Syntax

param1
USHORT nFieldInfo;   /* Number of FIELDINFO structures to be allocated. */

param2
ULONG ulReserved;    /* Reserved value, should be 0. */

Parameters

nFieldInfo (USHORT) - Input

Number of FIELDINFO structures to be allocated.

The value of this parameter must be greater than 0.

ulReserved (ULONG) - Input

Reserved value, should be 0.

Returns

pFieldInfo (PFIELDINFO) - returns

Pointer or error.

0: Reserved value, 0. The WinGetLastError function may return the following errors:

PMERR_INSUFFICIENT_MEMORY

PMERR_INVALID_PARAMETERS

Other: If the nFieldInfo parameter has a value of 1, a pointer to a FIELDINFO data structure is returned.

A pointer to the first FIELDINFO structure in a linked list of FIELDINFO structures is returned if the nFieldInfo parameter has a value greater than 1. The pointer to the next FIELDINFO structure is set in each pNextFieldInfo field of the FIELDINFO data structure. The last pointer is set to NULL.

Remarks

The container control requires that the application use the CM_ALLOCDETAILFIELDINFO message to allocate memory for any FIELDINFO structures that are used.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it other than to return NULL.