CeOidGetInfoEx2 (CEDB) (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function retrieves information about an object in the object store or a mounted database volume, or of the object store. Use the CREATE_SYSTEMGUID macro to obtain the GUID of the object store.

This function does not work with EDB databases. For more information, see EDB Functions.

Syntax

BOOL CeOidGetInfoEx2( 
  PCEGUID pceguid, 
  CEOID oid,
  CEOIDINFOEX* poidInfo
);

Parameters

  • pceguid
    [in] Pointer to the CEGUID that contains the globally unique identifierof a mounted database.
  • oid
    [in] Identifier of the object for which information is to be retrieved.
  • poidInfo
    [out] Pointer to a CEOIDINFOEX (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

There are the following differences between the CeOidGetInfo (CEDB), the CeOidGetInfoEx (CEDB), and the CeOidGetInfoEx2 functions:

  • CeOidGetInfo and CeOidGetInfoEx return ERROR_NOT_SUPPORTED if they are called on an OID whose data cannot be marshaled into the CEOIDINFO structure.
  • If CeOidGetInfo and CeOidGetInfoEx are called on a database with a sort order that has multiple sort properties, it returns correctly, but only the first sort property is returned in the CEOIDINFO structure.

This function can be used to retrieve information about any object in mounted database volumes in addition to the object store databases.

Note

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 .NET 4.0 and later

See Also

Reference

CEDB Functions
CeCreateDatabaseEx2 (CEDB)
CeOpenDatabaseEx2 (CEDB)
CREATE_SYSTEMGUID
CEOIDINFOEX (CEDB)
CeGetDBInformationByHandle (CEDB)

Concepts

Using Object Identifiers