DmCreateDatabase

DmCreateDatabase
Předcházející	PalmOS API	Další

$Header: /home/radek/cvs/forth-book/dictionary/qf/palmos-api/DmCreateDatabase,v 1.1 2003/12/28 18:21:58 radek Exp $

Jméno

DmCreateDatabase — Vytvoří novou databázi na uvedné kartě, s uvedeným názvem, tvůrcem a typem.

Přehled

DmCreateDatabase   ( resDB? type. creator. &nameP. cardNo → Err )

`Err DmCreateDatabase(`	`cardNo`,
	`nameP`,
	`creator`,
	`type`,
	`resDB)`;

UInt16	`cardNo`;
const Char *	`nameP`;
UInt32	`creator`;
UInt32	`type`;
bool	`resDB`;

→ cardNo: Číslo paměťové karty na které chceme databázi vytvořit.
→ nameP: Název databáze. Název může být dlouhý nejvýše 32 znaků v četně ukončujícího znaku null. Název databáze smí obsahovat jen 7-mi bitové ASCII znaky v rozsahu 0x20 až 0x7E.
→ creator: Identifikace tvůrce databáze.
→ type: Typ databáze.
→ resDB: Příznak zdrojové (resource) databáze.

Vrací:

errNone: nebyla li žádná chyba
dmErrInvalidDatabaseName: Špatné jméno databáze
dmErrAlreadyExists: Databáze již existuje

Vrátí 0 nenastala li chyba jinak memErrIvalidParam.

Příklad použití

Použití si ukážeme napříkladu vytvoření databáze Cvičná Databáze. Tuto databázi vytvořime jako obyčejnou, s identifikací tvůrce Test a typem databáze Data

# $Id: example:DmCreateDatabase.ses,v 1.1 2003/12/28 18:21:58 radek Exp $
needs zstrings
FALSE (ID) Data (ID) Test z" Cvičná databáze" DROP >ABS 0
DmCreateDatabase .

FIXME: See Also

DmDeleteDatabase, DmFindDatabase

Předcházející	Nahoru	Další
DmCloseDatabase	Domů	DmCreateDatabaseFromImage