Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function reads properties from the current record. CeReadRecordProps (RAPI)is a remote application interface, which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
CEOID CeReadRecordProps( HANDLE hDbase , DWORD dwFlags , LPWORD lpcPropID , CEPROPID * rgPropID , LPBYTE * lplpBuffer , LPDWORD lpcbBuffer );
Parameters
Value | Description |
---|---|
CEDB_ALLOWREALLOC | The LocalAllocfunction was used to allocate the buffer specified by the lplpBufferparameter, and the server can reallocate the buffer if it is not large enough to hold the requested properties. |
Return Values
The object identifier of the record from which the function read indicates success. Zero indicates failure. To get extended error information within a RAPI program, call CeGetLastError. Possible values for CeGetLastErrorinclude the following:
Remarks
The CeReadRecordProps(RAPI)function reads the specified set of properties from the current record. If the database was opened with the autoseek flag — that is, if the dwFlagsparameter of CeOpenDatabase (RAPI)was set to CEDB_AUTOINCREMENT — CeReadRecordProps (RAPI)increments the seek pointer by one so that the next call reads the next record in the current sort order. That is, if the database was opened with a sort order active, then CeReadRecordProps (RAPI)will return the records in sorted order. If the database was not opened with a sort order active, then the order in which records are returned is not predictable.
Read all needed properties from the record in a single call. The entire record is stored in a compressed format, and each time a property is read it must be decompressed. All the properties are returned in a single marshalled structure, which consists of an array of CEPROPVALstructures, one for each property requested — or one for each property found if the application set the rgPropIDparameter to NULL when calling the function.
If a property was requested, such as strings or blobs that are packed in at the end of the array, the pointers in the CEPROPVALstructures point into this marshalled structure. This means that the only memory that must be freed is the original pointer to the buffer passed in to the call. Even if the function fails, it may have allocated memory on the caller's behalf. Free the pointer returned by this function if the pointer is not NULL.
Note Earlier versions of Windows CE assigned OIDs to objects in other file systems, such as the FAT file system. These OIDs were guaranteed to be unique within a volume, but not across multiple volumes. Effective with version 3.0, only objects in the object store have valid, unique OIDs and the object store is the only volume that can return an object identifier.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 1.01 and later | Rapi.h |
See Also
CeOpenDatabase (RAPI), CeSeekDatabase (RAPI), LocalAlloc, CEPROPVAL