Zum Hauptinhalt springen

DrvOpenFile

DrvOpenFile​

Aufruf beim Öffnen einer Datei

Details

  • Request
  • MessageId: _DrvReqOpenFile Id des Ereignisses
  • ItemHeader: _DrvItemHeader Kopf des Datenpakets
  • ProtocolId: 0xF3A49E52 Id des verwendeten Protokolls
  • ProtocolVersion: 0x00040000 Version des verwendeten Protokolls
  • ItemAuthUserDomain: _DrvItemAuthUserDomain Informationsbereich des am Betriebssystem angemeldeten Benutzers
  • UserName: alpha Name des angemeldeten Benutzers
  • DomainName: alpha Domäne des angemeldeten Benutzers
  • ItemFilePath: _DrvItemFilePath Informationsbereich für die Datei
  • FilePath: alpha Pfad und Dateiname (ohne Laufwerksbuchstabe)
  • ItemFileCustom: _DrvItemFileCustom Informationsbereich für benutzerdefinierte Daten
  • Custom01: alpha Benutzerdefinierte Informationen
  • ItemFileHash: _DrvItemFileHash Informationsbereich der Prüfsumme
  • FileHash: alpha Prüfsumme der Datei
  • ItemCacheTime: _DrvItemCacheTime Informationsbereich für die Cache-Nutzung
  • CacheTime: bigint 0 oder der Zeitpunkt, zu dem die Datei zuletzt abgefragt wurde
  • ItemFileAccess: _DrvItemFileAccess Informationsbereich für die Zugriffsart
  • FsiFlags: int Zugriffsart (siehe Text)
  • Siehe: Verwandte Befehle

Dieses Ereignis wird aufgerufen, wenn eine Datei auf dem Laufwerk mit Lese- und/oder Schreibzugriff geöffnet wird. In dem Request wird der am Betriebssystem angemeldete Benutzer übergeben. In FilePath befindet sich der Pfad (ohne Laufwerksbuchstaben) und der Dateiname der geöffneten Datei. Wurden der Datei benutzerspezifische Informationen zugeordnet, befinden sich diese in Custom01. 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 von FsiFlags kann mit folgenden Konstanten, oder Kombinationen davon, verglichen werden:

Über die Prüfsumme oder den Cache-Zeitpunkt kann der Programmierer entscheiden, ob sich die Datei in der Zwischenzeit geändert hat und neu übertragen werden muss. Ist das der Fall, muss in der Response im Item ItemContentChanged der Wert true übermittelt werden. Anschließend wird das Ereignis DrvReadFile ausgelöst, um den Dateiinhalt neu zu übertragen.

  • Response
  • MessageId
    • _DrvResOpenFile
    • Id der Antwort
  • ItemHeader
    • _DrvItemHeader
    • Kopf des Datenpakets
  • ProtocolId
    • 0xF3A49E52
    • Id des verwendeten Protokolls
  • ProtocolVersion
    • 0x00040000
    • Version des verwendeten Protokolls
  • ItemFileCustom
  • Custom01
    • alpha
    • Benutzerdefinierte Informationen
  • ItemFileSize
  • FileSize
    • bigint
    • Größe der Datei (in Bytes)
  • ItemFileAttributes
  • FileAttributes
    • int
    • Dateiattribute
  • ItemFileTime
  • CreationTime
    • bigint
    • Zeitstempel der Erzeugung der Datei
  • LastAccessTime
    • bigint
    • Zeitstempel des letzten Zugriffs
  • LastWriteTime
    • bigint
    • Zeitstempel der letzten Änderung
  • ItemFileAuthorisation
  • UserId
    • int
    • Zugriffs-Id
  • Authorisation
    • int
    • Berechtigungen
  • ItemContentChanged
  • ContentChanged
  • ItemResult
  • 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 sind. 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.

Der Bereich ItemContentChanged muss zurückgegeben werden. Dieses Item bestimmt, ob die Datei geändert wurde. Das Ereignis DrvReadFile wird nur ausgelöst, wenn true übertragen wird. Mit Hilfe der Items ItemCacheTime und ItemFileHash aus dem Request kann ermittelt werden, ob in dem Bereich true oder false übertragen werden muss.

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

Beispiel:

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

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

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileCustom); // no custom data
  tDrvMsxWrite->MsxWrite(_MsxData, '');

  // 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, _DrvItemContentChanged); // file content changed?
  tDrvMsxWrite->MsxWrite(_MsxData, true);

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

  tDrvMsxWrite->MsxClose();
}