DEPRAG Smart Dokumentation

GetDrives

TwinCAT

Lokal Laufwerks-Management

ns=2;s=DEPRAG Smart/Local/DriveManagement/GetDrives

Der Befehl gibt eine Liste aller logischen Laufwerke mit ihren Eigenschaften zurück.

Rückgabewert:

Eine Variable vom Typ OpcMethodReturnValueDriveInfo. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.

Result

Ein Array von DriveInfo-Objekten.

AvailableFreeSpaceInByte
Verfügbarer Speicherplatz des Laufwerkes in Byte.

DriveFormat
Name des Dateisystems.

DriveType
Typ des Laufwerks. Die Enumeration hat folgende Ausprägungen:
Unknown
NoRootDirectory
Removable
Fixed
Network
CDRom
Ram

IsReady
Gibt an, ob das Laufwerk bereit ist.

Name
Name des Laufwerks.

TotalFreeSpaceInByte
Verfügbarer Speicherplatz des Laufwerkes in Byte.

TotalSizeInByte
Die Gesamtgröße des Laufwerks in Byte.

VolumeLabel
Die Volumenbezeichnung des Laufwerks.

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

bDriveManagementGetDrives
Eine boolesche Variable, über welche die Ausführung des GetDrives-Befehls getriggert werden kann.

OutputDataDriveManagementGetDrives
Eine Instanz der "ST_GetDrivesOutputData", in welche der Rückgabewert der GetDrives-Methode geschrieben wird.

hrDriveManagementGetDrives
Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".

fbDriveManagement
Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_DriveManagement" Funktionsbausteins.

ConnectionHandle
Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle".



VAR
          bDriveManagementGetDrives     : BOOL;
          OutputDataDriveManagementGetDrives    : ST_GetDrivesOutputData;
          hrDriveManagementGetDrives     : HRESULT;

          fbDriveManagement : FB_DriveManagement;
END_VAR

hrDriveManagementGetDrives := fbDriveManagement.GetDrives(
          bExecute    := bDriveManagementGetDrives,   
          ConnectionHandle := depragSmartConnection.ConnectionHandle, 
          OutputData   => OutputDataDriveManagementGetDrives);
IF hrDriveManagementGetDrives <> S_FALSE THEN 
          bDriveManagementGetDrives := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.