---
name: "DlpReadOpenDBInfo"
section: "3"
platform: "linux"
package: "coldsync"
version: "3.0+pre3-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/DlpReadOpenDBInfo"
---

# DlpReadOpenDBInfo(3)

read information about a PalmOS database

## NAME

**DlpReadOpenDBInfo** – read information about a PalmOS database

## LIBRARY

*libpconn*

## SYNOPSIS

**#include \<palm.h\>**

**#include \<pconn/pconn.h\>**

*int*\

**DlpReadOpenDBInfo**(*PConnection \*pconn*, *ubyte handle*, *struct dlp\_opendbinfo \*dbinfo*);

## DESCRIPTION

**DlpReadOpenDBInfo** reads information about a database on the Palm.

*handle* is the database handle given by **DlpOpenDB**.

*dbinfo* is filled in with information about the database. The *dlp\_opendbinfo* structure is trivial:

```
struct dlp_opendbinfo
{
	uword numrecs;
};
```

where *numrecs* is the number of records or resources in the database.

## RETURN VALUE

**DlpReadOpenDBInfo** returns 0 if successful, or a negative value otherwise.

## NOTES

The fact that this function takes an entire structure for a single value may be considered a bug. However, with a name like “read open DB info,” it seems likely that in future versions, this function might return far more information.

## SEE ALSO

[libpconn(3)](/libpconn/3.md), [DlpOpenDB(3)](/DlpOpenDB/3.md).