CeOidGetInfoEx (CEDB) (Windows Embedded CE 6.0)

1/6/2010

This function retrieves information about an object in the object store or a mounted database volume. This function is obsolete. Call the CeOidGetInfoEx2 (CEDB) function instead.

A RAPI version of this function exists called CeOidGetInfoEx (RAPI).

Syntax

BOOL CeOidGetInfoEx( 
  PCEGUID pceguid, 
  CEOID oid,
  CEOIDINFO* poidInfo
);

Parameters

  • pceguid
    [in] Pointer to the CEGUID that contains the globally unique identifier (GUID) of a mounted database volume or of the object store. Use the CREATE_SYSTEMGUID macro to obtain the GUID of the object store.
  • oid
    [in] Identifier of the object for which information is to be retrieved.
  • poidInfo
    [out] Pointer to a CEOIDINFO (CEDB) structure that contains information about the object.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. GetLastError may return ERROR_INVALID_HANDLE if the specified object identifier is invalid.

Remarks

The difference between the CeOidGetInfo (CEDB) function and this function is that CeOidGetInfo retrieves information about objects only in the object store databases, while this function retrieves information about any object in mounted database volumes, in addition to the object store databases.

Earlier versions (2.12 and earlier) of Windows Embedded 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 Windows CE 3.0, the only file and directory objects that have valid, unique OIDs are in the object store. Database objects on any file system have valid, unique OIDs.

Requirements

Header windbase.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

CEDB Functions
CeCreateDatabaseEx (CEDB)
CeOpenDatabaseEx (CEDB)
CREATE_SYSTEMGUID
CEOIDINFO (CEDB)
CeOidGetInfo (CEDB)
CeOidGetInfoEx2 (CEDB)

Concepts

Using Object Identifiers