Methode ITcFileAccess:FileRename

Benennt eine Datei um.

Syntax

virtual HRESULT TCOMAPI FileRename(PCCH szOldName, PCCH szNewName);

Parameter

szOldName: (Typ: PCCH) [in] der umzubenennende Dateiname.

szNewName: (Typ: PCCH) [in] der neue Dateiname.

Rückgabewert

Bei Erfolg wird S_OK („0“) oder ein anderer positiver Wert zurückgegeben, vgl. Rückgabewerte. Erweiterte Meldungen beziehen sich dabei insbesondere auf die Spalte HRESULT in ADS Return Codes.

Ein besonders interessanter Fehlercode ist ADSERR_DEVICE_TIMEOUT wenn die Zeitüberschreitung (5 Sekunden) abgelaufen ist.

Beschreibung

Diese Methode benennt eine Datei mit einem neuen Namen um.