Zum Hauptinhalt springen

C16_FileInfoByName

C16_FileInfoByName(const vPHANDLE aInstHdl, const vCHAR* aFileName, vC16_FileInfo* aInfoBlock) : vERROR​

Informationen zu einer Datei ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_FileInfo mit Informationen zu einer in der Datenstruktur definierten Datei. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT  InfoSize;
  vINT  FileNumber;
  vINT  FileMaster;
  vINT  FileSbrCount;
  vINT  FileKeyCount;
  vINT  FileLinkCount;
  vCHAR FileName[24];
}
vC16_FileInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • FileNumber: Dateinummer
  • FileMaster: Nummer der Hauptdatei (bei einer untergeordneten Datei)
  • FileSbrCount: Anzahl der Teildatensätze
  • FileKeyCount: Anzahl der Schlüssel
  • FileLinkCount: Anzahl der Verknüpfungen
  • FileName[24]: Dateiname

Als Parameter der Funktion müssen der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde (aInstHdl), der Name der Datei, zu der die Informationen ermittelt werden sollen und ein Zeiger auf eine vC16_FileInfo-Struktur, die mit Informationen zu der Datei gefüllt wird, übergeben werden. Die Strukturkomponente InfoSize muss vor der Übergabe mit der Größe der Struktur initialisiert werden (sizeof(vC16_FileInfo)).

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).