DrvRenameFile

Aufruf beim Umbenennen einer Datei

Details

Request
MessageId: _DrvReqRenameFile 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 der Datei
FilePath: alpha Pfad und Dateiname (ohne Laufwerksbuchstabe)
ItemFileCustom: _DrvItemFileCustom Informationsbereich für benutzerdefinierte Daten
Custom01: alpha Benutzerdefinierte Informationen
ItemFileNameNew: _DrvItemFileNameNew Informationsbereich des neuen Dateinamens
FileNameNew: alpha Neuer Name der Datei
Siehe: Verwandte Befehle

Das Ereignis wird ausgelöst, wenn eine Datei umbenannt wird. Der neue Dateiname befindet sich in FileNameNew.

Response
MessageId
- _DrvResRenameFile
- Id der Antwort
ItemHeader
- _DrvItemHeader
- Kopf des Datenpakets
ProtocolId
- 0xF3A49E52
- Id des verwendeten Protokolls
ProtocolVersion
- 0x00040000
- Version des verwendeten Protokolls
ItemFileCustom
- _DrvItemFileCustom
- Informationsbereich für benutzerdefinierte Daten (optional)
Custom01
- alpha
- Benutzerdefinierte Informationen
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 Datei wird nur dann umbenannt, wenn in Result _ErrOk (0) angegeben wird. Durch das Setzen eines _ErrFsi...-Wertes können andere Fehlerzustände übermittelt werden.

Beispiel:

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

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

  tDrvMsxWrite->MsxWrite(_MsxItem, _DrvItemFileCustom); // no custom information
  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, _DrvItemResult); // Write result
  tDrvMsxWrite->MsxWrite(_MsxData, _ErrOk);
  tDrvMsxWrite->MsxWrite(_MsxEnd, 0);

  tDrvMsxWrite->MsxClose();
}

DrvRenameFile​

DrvRenameFile