CeGetDBInformationByHandle (EDB) (Windows CE 5.0)

Send Feedback

This function obtains information about an open database by using the handle of the database.

This function does not work with CEDB databases. For more information about CEDB, see CEDB Reference.

BOOL CeGetDBInformationByHandle(HANDLEhDbase,BY_HANDLE_DB_INFORMATION*lpDBInfo);

Parameters

  • hDbase
    [in] A handle to an open database. This handle must be obtained by calling the CeOpenDatabaseInSession (EDB) function.
  • lpDBInfo
    [in/out] A pointer to a BY_HANDLE_DB_INFORMATION (EDB) structure. The caller must set *lpDBInfo->*wVersion to BY_HANDLE_DB_INFORMATION_VERSION before calling this function.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError. The following table lists possible values returned by GetLastError:

Return Value Description
ERROR_INVALID_PARAMETER Indicates one of the following:
  • lpDBInfo is NULL.
  • lpDBInfo->wVersion is not equal to BY_HANDLE_DB_INFORMATION_VERSION.
ERROR_INVALID_HANDLE Indicates that hDbase is NULL or equal to INVALID_HANDLE_VALUE.

Requirements

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

See Also

CeOpenDatabaseInSession (EDB) | BY_HANDLE_DB_INFORMATION (EDB)

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.