_FCreate( ), API-Bibliotheksroutine

Weist einer neuen Datei einen Visual FoxPro-Kanal zu.

FCHAN _FCreate(char FAR *filename, int mode)
char FAR *filename;         /* Name of file to create. */
int mode;                     /* File attributes. */

Hinweise

Wenn bereits eine Datei mit dem angegebenen Namen vorhanden ist, reduziert _FCreate( ) die Länge der vorhandenen Datei auf null Bytes.

Der Parameter mode kann eines oder mehrere der folgenden Attribute annehmen: FC_READONLY, FC_SYSTEM, FC_HIDDEN und FC_TEMPORARY. Sie haben die Möglichkeit, diese Attribute mit dem C-Operator | oder dem +-Operator zu kombinieren. Das zusätzliche Attribut FC_NORMAL gibt an, dass die Datei keines der anderen Attribute aufweist. FC_TEMPORARY-Dateien werden automatisch gelöscht, wenn Sie _FClose( ) zum Schließen der Datei aufrufen.

_FCreate( ) gibt den Dateikanal zurück, wenn die Datei erstellt wurde. Konnte die Datei nicht erstellt werden, wird -1 zurückgegeben.

Weitere Informationen zum Erstellen einer API-Bibliothek und ihrer Integration in Visual FoxPro finden Sie unter Zugreifen auf die Visual FoxPro-API.

Beispiel

Im folgenden Beispiel wird mit _FCreate( ) eine Reihe von Dateien erstellt, die die verschiedenen mode-Attribute von _FCreate( ) verwenden.

Visual FoxPro-Code

SET LIBRARY TO FCREATE 

C-Code

#include <pro_ext.h>

FAR Example(ParamBlk FAR *parm)
{
   FCHAN fchan;

   fchan = _FCreate("normal.tmp", FC_NORMAL);
   _FClose(fchan);

   fchan = _FCreate("readonly.tmp", FC_READONLY);
   _FClose(fchan);

   fchan = _FCreate("hidden.tmp", FC_HIDDEN);
   _FClose(fchan);

   fchan = _FCreate("system.tmp", FC_SYSTEM);
   _FClose(fchan);

   fchan = _FCreate("temp.tmp", FC_TEMPORARY);
   _FClose(fchan);

   fchan = _FCreate("multi.tmp", FC_SYSTEM | FC_READONLY);
   _FClose(fchan);
}

FoxInfo myFoxInfo[] = {
   {"FCREATE", (FPFI) Example, CALLONLOAD, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Siehe auch

_FClose( ), API-Bibliotheksroutine | _FOpen( ), API-Bibliotheksroutine | Zugreifen auf die Visual FoxPro-API