CeOidGetInfoEx2

  • Article

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

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

Parameters

  • pceguid
    [in] Pointer to the CEGUID that contains the globally unique identifier of a mounted database.
  • oid
    [in] Identifier of the object for which information is to be retrieved.
  • poidInfo
    [out] Pointer to a CEOIDINFOEX structure that contains information about the object.

Return Values

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 two differences between CeOidGetInfo, CeOidGetInfoEx and CeOidGetInfoEx2:

  • CeOidGetInfo and CeOidGetInfoEx will 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 will return correctly, but only the first sort property will be returned in the CEOIDINFO structure.

CeOidGetInfoEx2 may 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 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, 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Windbase.h.
Link Library: Coredll.lib.

See Also

CeCreateDatabaseEx2 | CeOpenDatabaseEx2 | CREATE_SYSTEMGUID | CEOIDINFOEX | CeGetDBInformationByHandle | Using Object Identifiers | CeOidGetInfoEx (RAPI)

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.