Schnittstelle ITcFileAccessAsync
Asynchroner Zugriff auf Dateioperationen. Diese Schnittstelle erweitert ITcFileAccess.
Syntax
TCOM_DECL_INTERFACE("C04AC244-C126-466E-982E-93EC571F2277", ITcFileAccessAsync) struct __declspec(novtable) ITcFileAccessAsync: public ITcFileAccess Benötigtes include: TcFileAccessInterfaces.h
Methoden
Schnittstellenparameter
Name | Beschreibung |
|---|---|
PID_TcFileAccessAsyncSegmentSize | Größe der an System-Service übergebenen Segmente. |
PID_TcFileAccessAsyncTimeoutMs | Setzt den Timeout in [ms]. |
PID_TcFileAccessAsyncNetId(Str) | NetId des zu kontaktierenden System-Service. |
Anmerkungen
Schnittstelle kann von Modulinstanz mit Klassen-ID CID_TcFileAccessAsync erhalten werden.
Bei Verwendung der asynchronen Schnittstelle, geben die von der synchronen Variante geerbten Schnittstellenmethoden ADS_E_PENDING zurück, wenn eine Abfrage erfolgreich unterbreitet, aber noch nicht abgeschlossen wurde. Wenn der Aufruf eingeht, während die vorherige Anfrage immer noch abgearbeitet wurde, wird der Fehlercode ADS_E_BUSY zurückgegeben.
Beschreibung der Modulparameter:
- PID_TcFileAccessAsyncAdsProvider: Objekt-ID einer Task, die die ADS-Schnittstelle bereitstellt.
- PID_TcFileAccessAsyncNetId / PID_TcFileAccessAsyncNetIdStr: AmsNetId des System-Service, der für den Dateizugriff verwendet wird. Die „Str“ Variante nimmt die AmsNetId als Zeichenkette. Bitte eins verwenden.
- PID_TcFileAccessAsyncTimeoutMs: Zeitüberschreitung für einen Dateizugriff.
- PID_TcFileAccessAsyncSegmentSize: Der Lese- und Schreibzugriff auf Datei wird mit dieser Segmentgröße fragmentiert.