CM QUERYRECORDINFO

This message updates the specified records with the current information for the container.

Syntax

param1
PVOID pRecordArray; /* Pointer to an array of pointers to RECORDCORE structures to which the current information is to be copied. */

param2
USHORT cNumRecord;  /* Number of records. */

Note

; If the CCS_MINIRECORDCORE style bit is specified when a container is created, then MINIRECORDCORE should be used instead of RECORDCORE, and PMINIRECORDCORE should be used instead of PRECORDCORE all applicable data structures and messages.

Parameters

pRecordArray (PVOID) - Input

Pointer to an array of pointers to RECORDCORE structures to which the current information is to be copied.

cNumRecord (USHORT) - Input

Number of container records to be updated. If the cNumRecord parameter has a value of 0, all of the records in the container are updated and the pRecordArray parameter is ignored.

Returns

rc (BOOL) - returns

Success indicator.

TRUE: Record information was successfully updated.

FALSE: An error occurred. The WinGetLastError function may return the following error:

PMERR_INVALID_PARAMETERS.

Remarks

This message is needed only if the application is sharing records among multiple containers in the same process.

The flRecordAttr and ptlIcon fields are updated internally when they change, but not in the external RECORDCORE structure. Therefore, the application's external record does not always have current information in these fields. This message is only needed if the application is sharing records among multiple containers in the same process.

Default Processing

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