CM QUERYDETAILFIELDINFO

This message returns a pointer to the requested FIELDINFO structure.

Syntax

param1
PFIELDINFO pfldinfoBase; /* Pointer to the FIELDINFO structure used to search for the next or previous column. */

param2
USHORT cmd;            /* Command that indicates which FIELDINFO structure to retrieve. */

Parameters

pfldinfoBase (PFIELDINFO) - Input

Pointer to the FIELDINFO structure used to search for the next or previous column. If the CMA_FIRST or CMA_LAST attribute is specified, this is ignored.

cmd (USHORT) - Input

Command that indicates which FIELDINFO structure to retrieve.

CMA_FIRST: First column in the container.

CMA_LAST: Last column in the container.

CMA_NEXT: Next column in the container.

CMA_PREV: Previous column in the container.

Returns

pFieldInfo (PFIELDINFO) - returns

Pointer to the FIELDINFO structure for which data was requested.

NULL: No FIELDINFO structures to retrieve.

-1: The data from the FIELDINFO structure was not returned. The WinGetLastError function may return the following error:

PMERR_INVALID_PARAMETERS.

Other: Pointer to the FIELDINFO structure for which data was requested.

Remarks

If the cmd parameter has the value of the CMA_FIRST or CMA_LAST attribute, the pfldinfoBase parameter is ignored and the first or last column data, respectively, is returned. If the CMA_NEXT or the CMA_PREV attribute is set in the cmd parameter, the column data next to or before the column pointed to by the pFieldInfo parameter is returned.

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.