DrvReadFile

Dieses Ereignis wird ausgelöst, wenn eine Datei gelesen wird. In dem Bereich ItemAuthUserDomain wird der Benutzer und die Domäne des beim Betriebssystem angemeldeten Benutzers übergeben. In FilePath und Custom01 befinden sich der Pfad und Dateiname auf dem Laufwerk und die benutzerdefinierten Informationen der Datei. In FileHash wird die Prüfsumme der Datei übertragen, die beim letzten Aufruf von DrvReadFile gesetzt wurde. Befindet sich die Datei bereits im Cache, wird in CacheTime der Zeitpunkt angegeben, zu dem die Datei zuletzt mit DrvReadFile abgefragt wurde. Befindet sich die Datei nicht im Cache, wird 0 übergeben. Der Inhalt der Datei muss in das temporäre Verzeichnis ausgelagert werden. Das Laufwerk und der Pfad dazu befindet sich in TempPath.

Über die Prüfsumme kann der Programmierer entscheiden, ob sich die Datei in der Zwischenzeit geändert hat und neu übertragen werden muss.

Das Antwort-Datenpaket darf erst versendet werden, wenn die Informationen vollständig zur Verfügung stehen.

Der Laufwerkstreiber erwartet folgendes Datenpaket als Antwort:

• Response
• MessageId
  • _DrvResReadFile
  • Id der Antwort
• ItemHeader
  • _DrvItemHeader
  • Kopf des Datenpakets
• ProtocolId
  • 0xF3A49E52
  • Id des verwendeten Protokolls
• ProtocolVersion
  • 0x00040000
  • Version des verwendeten Protokolls
• ItemContentChanged
  • _DrvItemContentChanged
  • Informationsbereich für geänderte Inhalte
• ContentChanged
  • logic
  • Datei wurde geändert (true)
• ItemFileCustom
  • _DrvItemFileCustom
  • Informationsbereich für benutzerdefinierte Daten (optional)
• Custom01
  • alpha
  • Benutzerdefinierte Informationen
• ItemFileHash
  • _DrvItemFileHash
  • Informationsbereich der Prüfsumme
• FileHash
  • alpha
  • Hash der gespeicherten Datei
• ItemFileContentDisk
  • _DrvItemFileContentDisk
  • Informationsbereich für den Inhalt der Datei
• FilePath
  • alpha
  • Pfad und Dateiname der Datei im temporären Pfad
• ItemFileSize
  • _DrvItemFileSize
  • Informationsbereich der Dateigröße (optional)
• FileSize
  • bigint
  • Größe der Datei (in Bytes)
• ItemFileAttributes
  • _DrvItemFileAttributes
  • Informationsbereich für Dateiattribute (optional)
• FileAttributes
  • int
  • Dateiattribute
• ItemFileTime
  • _DrvItemFileTime
  • Informationsbereich für Dateidatum und -uhrzeit (optional)
• CreationTime
  • bigint
  • Zeitstempel der Erzeugung der Datei
• LastAccessTime
  • bigint
  • Zeitstempel des letzten Zugriffs
• LastWriteTime
  • bigint
  • Zeitstempel der letzten Änderung
• ItemFileAuthorisation
  • _DrvItemFileAuthorisation
  • Informationsbereich für Berechtigungen (optional)
• UserId
  • int
  • Zugriffs-Id
• Authorisation
  • int
  • Berechtigungen
• ItemResult
  • _DrvItemResult
  • Ergebnis-Bereich
• Result
  • int
  • Ergebniswert

Die Bereiche ItemFileCustom, ItemFileSize, ItemFileAttributes, ItemFileTime und ItemFileAuthorisation sind optional. Die Informationen werden nur dann geändert, wenn diese Bereiche im Antwortdatenpaket enthalten ist. Zum Löschen der Daten muss ein Leerstring oder 0 (für die int-Werte) angegeben werden. Bei ItemFileTime muss immer ein gültiger Zeitstempel angegeben werden, wenn dieser gesetzt wird.

Die Bereiche ItemFileHash und ItemFileContentDisk müssen nur dann angegeben werden, wenn sich der Inhalt der Datei geändert hat, also im Antwortpaket ContentChanged auf true gesetzt ist. Das ItemFileHash kann beim nächsten Aufruf von DrvOpenFile und DrvReadFile verwendet werden, um zu prüfen, ob die Datei verändert wurde.

Die Datei wird nur dann gelesen, wenn in Result _ErrOk (0) angegeben wird. Durch das Setzen eines _ErrFsi...-Wertes können andere Fehlerzustände übermittelt werden.

Beispiel:

if (tDrvRequestMessageId = _DrvReqReadFile)
{
  tDrvMsxWrite # MsxOpen(_MsxSocket | _MsxWrite, tSck);

  tDrvMsxWrite->MsxWrite(_MsxMessage, _DrvResReadFile);
  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemHeader); // ItemHeader
  tDrvMsxWrite->MsxWrite(_MsxData, 0xF3A49E52);     // ProtocolId
  tDrvMsxWrite->MsxWrite(_MsxData, 0x00040000);     // ProtocolVersion

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemContentChanged); // content changed?
  tDrvMsxWrite->MsxWrite(_MsxData, false);
  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileCustom); // no custom information
  tDrvMsxWrite->MsxWrite(_MsxData, '');
//  ... Export new information to tFileName
//  tFileName # tRequestTempPath + '\' + ...;
//  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileHash); // changed file hash
//  tDrvMsxWrite->MsxWrite(_MsxData, StrCnv(StrCnv(FsiFileInfo(tFileName, _FsiFileRMD160), _StrToUtf8), _StrFromAnsi);
//  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileContentDisk); // path and filename
//  tDrvMsxWrite->MsxWrite(_MsxData, tFileName);

  // File size
  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileSize); // set file size
  tDrvMsxWrite->MsxWrite(_MsxData, tImportedFile->FsiSize64());

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileAttributes); // set same attributes
  tDrvMsxWrite->MsxWrite(_MsxData, tRequestFileAttributes);

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileTime); // set file time
  tDrvMsxWrite->MsxWrite(_MsxData, tRequestFileCreationTime);
  tCalSystemTime->vmSystemTime();
  tDrvMsxWrite->MsxWrite(_MsxData, CnvBC(tCalSystemTime));
  tDrvMsxWrite->MsxWrite(_MsxData, CnvBC(tCalSystemTime));

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileAuthorisation); // user authorisation for admins
  tDrvMsxWrite->MsxWrite(_MsxData, 10);
  tDrvMsxWrite->MsxWrite(_MsxData, _DrvAuthAll); // all rights

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileAuthorisation); // user authorisation for everybody else
  tDrvMsxWrite->MsxWrite(_MsxData, 12);
  tDrvMsxWrite->MsxWrite(_MsxData, _DrvAuthList | _DrvAuthRead); // read only

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemResult); // Write result
  tDrvMsxWrite->MsxWrite(_MsxData, _ErrOk);
  tDrvMsxWrite->MsxWrite(_MsxEnd, 0);

  tDrvMsxWrite->MsxClose();
}