AdsFCreate
Creates or truncates a file under the data root and returns a writable handle.
Harbour-style name: oads_FCreate (see Server filesystem).
Syntax
UNSIGNED32 AdsFCreate(ADSHANDLE hConnect, UNSIGNED8 *pucName,
UNSIGNED16 usAttribute, ADSHANDLE *phFile);
Parameters
| Parameter | Type | Description |
|---|---|---|
hConnect |
ADSHANDLE |
Connection handle (0 = default). |
pucName |
UNSIGNED8* |
Relative file path. |
usAttribute |
UNSIGNED16 |
Reserved (pass 0). |
phFile |
ADSHANDLE* |
Out: file handle. |
Return Value
AE_SUCCESS (0).
Description
Parent directories should already exist (or create them with AdsDirMake). Truncates if the file already exists.
Example
ADSHANDLE hFile = 0;
AdsFCreate(hConn, (UNSIGNED8*)"inbox/new.txt", 0, &hFile);