CM_ALLOCRECORD - Parameters

cbRecordData (ULONG)

Bytes of additional memory.

The number of bytes of additional memory that you want to reserve for your application's private use. This parameter must have a value between 0 and 64,000. If the value is 0, no additional memory is allocated, but a RECORDCORE data structure is allocated.

nRecords (USHORT)

Number of records.

The number of container records to be allocated. This parameter must have a value greater than 0.

pRecord (PRECORDCORE)

Returns a pointer or an error.

NULL

Allocation failed. The WinGetLastError function may return the following errors:

• PMERR_INSUFFICIENT_MEMORY 
  PMERR_INVALID_PARAMETERS.
  Other
  If the nRecords parameter has a value of 1, a pointer to a RECORDCORE structure is returned.

  If the nRecords parameter has a value greater than 1, a pointer to the first RECORDCORE structure in the linked list of records is returned. The pointer to the next container record is set in the preccNextRecord field in each RECORDCORE data structure. The last pointer is set to NULL.

  ---

  [Back: CM_ALLOCRECORD Return Value - pRecord]
  [Next: CM_ALLOCRECORD - Syntax]