Zum Hauptinhalt springen

_DrvItem...

_DrvItem... Beschreibung der Informationsbereich der Datenpakete

Die Datenpakete (Request und Response) sind in Informationsbereiche unterteilt. Jeder Informationsbereich wird mit einem Msx-Item eingeleitet. Dieses Item hat eine Nummer, die mit den hier beschriebenen Konstanten verglichen werden kann. Der Wert der Konstanten steht in Klammern dahinter. In einem Informationsbereich sind eine fest vorgegebene Anzahl von Informationen hinterlegt. Bei den Ereignissen sind die im Request und Responds vorhandenen Informationsbereiche beschrieben. Im folgenden befindet sich eine Liste alle Bereiche.

  • _DrvItemAuthUserDomain (1050) Informationsbereich des am Betriebssystem angemeldeten Benutzers.

  • alpha: Benutzername des angemeldeten Benutzers

  • alpha: Domäne des angemeldeten Benutzers

  • _DrvItemAuthAccessId (1051) Informationsbereich der Zugriffs-Berechtigungen.

  • int: Zugriffs-Id

  • _DrvItemCacheTime (1015) Informationsbereich für den Zeitpunkt, zu dem die Datei oder das Verzeichnis in den Cache geschrieben wurde. Der Zeitpunkt wird als Zeitstempel angegeben. Die Verarbeitung kann in einer Variable von Typ caltime erfolgen. Der Wert muss dann mit CnvCB () gewandelt werden.

  • bigint: Datum und Uhrzeit der letzten Abfrage

  • _DrvItemCfgCacheDisk (1022) Informationsbereich über den Cache des Laufwerkstreiber. Standardmäßig wird das Verzeichnis DRIVE_CACHE im temporären Pfad des Betriebssystems angelegt. Wird ein anderer Pfad angegeben, wird dort ebenfalls das Verzeichnis DRIVE_CACHE erzeugt. Das Verzeichnis wird beim Beenden des Laufwerkstreibers entfernt.

info

Der Inhalt des Verzeichnisses wird beim Start vollständig geleert. Sollten dort Dateien (z. B. anderer Programme) enthalten sein, sind diese nach dem Start des Laufwerkstreibers nicht mehr vorhanden. Es ist daher wichtig, dass dieses Verzeichnis exklusiv dem Laufwerkstreiber zur Verfügung steht.

  • bigint: maximale Größe des Caches

  • alpha: Pfad für temporäre Dateien

  • _DrvItemCfgIgnoreMaskRequest (1024) Informationsbereich der Dateimaske. In diesem Bereich werden Dateimasken angegeben, für die keine DrvGetFileInfo -Nachrichten erzeugt werden sollen.

  • alpha: Pipe-separierte ( | ) Liste

  • _DrvItemCfgMountLocal (1020) Informationsbereich über das lokale Laufwerk.

  • alpha: Laufwerksbuchstabe

  • _DrvItemCfgMountNetwork (1021) Informationsbereich über die Netzwerkfreigabe.

  • alpha: Freigabename

  • _DrvItemComputerName (1013) In diesem Informationsbereich wird der Name des Computers übergeben, auf dem der Laufwerkstreiber gestartet wurde.

  • alpha: Name des Computers

  • _DrvItemContentChanged (1012) Informationsbereich für geänderte Daten. Der Laufwerkstreiber hat einen eigenen Cache. Haben sich die Daten von einer Datei nicht geändert, kann in diesem Abschnitt angegeben werden, dass die Daten nicht erneut übertragen werden müssen.

  • logic: Daten geändert

  • _DrvItemDriverData (1014) Informationen über den eingesetzten Laufwerkstreiber.

  • alpha: Versionsnummer des installierten Treibers

  • _DrvItemErrorText (1010) Informationsbereich für Fehlertexte.

  • alpha: Fehlertext

  • _DrvItemFileAccess (1062) Informationsbereich für den Zugriffsmodus auf eine Datei.

  • int: Zugriffs-Flags

  • _DrvItemFileAttributes (1071) Informationsbereich für die Dateiattribute.

  • int: Dateiattribute

  • _DrvItemFileAuthorisation (1064) Informationsbereich für Zugriffsrechte.

  • int: Zugriffs-Id

  • int: Berechtigungen

Die Berechtigung kann als Kombination der folgenden Konstanten angegeben werden:

  • _DrvAuthAll: Alle Rechte vorhanden

  • _DrvAuthNone: Keine Rechte vorhanden

  • _DrvAuthList: Dateien und Verzeichnisse listen

  • _DrvAuthDelete: Dateien und Verzeichnisse löschen

  • _DrvAuthRename: Dateien und Verzeichnisse umbenennen

  • _DrvAuthMove: Dateien und Verzeichnisse verschieben

  • _DrvAuthSetAttributes: Attribute von Dateien und Verzeichnissen setzen

  • _DrvAuthRead: Datei lesen

  • _DrvAuthWrite: Datei schreiben

  • _DrvAuthExecute: Datei ausführen

  • _DrvAuthCreateDirectory: Verzeichnis erstellen

  • _DrvAuthCreateFile: Datei erstellen

  • _DrvItemFileContentDisk (1065) Informationsbereich für den Inhalt der Datei.

  • alpha: Pfad- und Dateiname der Datei im temporären Pfad

  • _DrvItemFileCustom (1063) Informationsbereich für benutzerdefinierte Daten

  • alpha: benutzerdefinierte Informationen

  • _DrvItemFileHash (1067) Informationsbereich für die Prüfsumme der Datei. Die Prüfsumme kann vom Programmierer verwendet werden, um eine Änderung an einer Datei festzustellen. Es kann dann entschieden werden, ob die Dateiinformationen erneut übertragen werden müssen.

  • alpha: Prüfsumme

  • _DrvItemFileName (1061) Informationsbereich für den Dateinamen.

  • alpha: Name der Datei

  • _DrvItemFileNameNew (1069) Informationsbereich für den neuen Dateinamen.

  • alpha: neuer Dateiname

  • _DrvItemFilePath (1060) Informationsbereich für den Pfad der Datei.

  • alpha: Pfad (ohne Laufwerksbuchstaben)

  • _DrvItemFilePathNew (1068) Informationsbereich für den neuen Pfad. Der Informationsbereich wird nur beim Verschieben einer Datei benötigt.

  • alpha: neuer Dateipfad

  • _DrvItemFileSize (1070) Informationsbereich für die Größe der Datei.

  • bigint: Größe der Datei in Bytes

  • _DrvItemFileSubData (1073) Informationsbereich für untergeordnete Daten. Dieser Bereich ist nur für Verzeichniseinträge relevant. Sind in dem Unterverzeichnis weder Dateien noch weitere Unterverzeichnisse, kann das hier angegeben werden. Ein Auswerten dieses Verzeichnisbaumes ist dann nicht notwendig.

  • logic: Verzeichnis leer

  • _DrvItemFileTime (1072) Informationsbereich für Datum und Uhrzeiten der Datei. Datum und Uhrzeit werden als Zeitstempel dargestellt. Die Verarbeitung kann in einer Variable von Typ caltime erfolgen. Der Wert muss dann mit CnvCB () bzw. CnvBC () gewandelt werden.

  • bigint: Datum und Uhrzeit der Dateierzeugung

  • bigint: Datum und Uhrzeit des letzten Zugriffs

  • bigint: Datum und Uhrzeit der letzten Änderung

  • _DrvItemResult (1001) Resultat der Operation. In diesem Abschnitt des Request-Datenpakets wird der Fehlerwert des Laufwerkstreibers angegeben. Bei einem Response-Datenpaket kann in diesem Abschnitt ein Resultat angegeben werden, das entweder an die Applikation weitergeleitet wird, die die Aktion auf dem Laufwerk ausgelöst hat, oder vom Laufwerkstreiber selbst ausgewertet wird.

  • int: Resultat-Wert

  • _DrvItemTempPath (1011) Informationsbereich für die Speicherung im temporären Pfad.

  • alpha: Pfad- und Dateiname im temporären Pfad

  • _DrvItemTimeout (1002) Informationsbereich für das zeitliche Verhalten der Applikation. Hier werden Angaben gemacht, wann eine Aktion noch mal durchgeführt werden soll.

  • int: Zeitraum in Millisekunden

  • _DrvItemVolumeId (1041) Informationsbereich für die Laufwerksnummer.

  • int: Laufwerks-Id

  • _DrvItemVolumeLabel (1042) Informationsbereich für den Laufwerksnamen.

  • alpha: Name des Laufwerks

  • _DrvItemVolumeSize (1040) Informationsbereich für die Laufwerksgröße und des freien Speicherplatzes.

  • bigint: freier Speicherbereich in Bytes

  • bigint: gesamte Speicherkapazität in Bytes