Item.Transfer-Methode

Die Transfer-Methode des Item-Objekts überträgt Daten von einem Gerät in eine Datei. Diese Methode gilt nur für Gerätetypelemente.

Syntax

Item.Transfer(
  Filename,
  AsyncTransfer = VARIANT_BOOL
)

Parameter

Dateiname [ In]

Typ: BSTR

Gibt den Namen der Datei an, in die die Daten übertragen werden.

AsyncTransfer [ In]

Typ: VARIANT _ BOOL

Ein boolescher Wert, der angibt, ob die Übertragung als asynchroner Aufruf ausgeführt werden soll.

(VARIANT _ BOOL)

Standard. Legen Sie diesen Wert auf TRUE fest, wenn der Aufruf asynchron sein soll (siehe Hinweise).

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

Diese Methode gilt nur für Dateitypelemente. Die -Methode überprüft, ob das Element diese Methode unterstützt, bevor versucht wird, die Datenübertragung abzuschließen.

Verwenden Sie die Zwischenablage als Filename-Parameter, um ein Element in die Zwischenablage zu übertragen.

Legen Sie den AsyncTransfer-Wert für Übertragungen innerhalb einer Anwendung oder eines Skripts, die in einer Umgebung ausgeführt werden, die einen Prozess am Ende eines Skripts beendet, wie z. B. Windows Script Host (WSH), auf FALSE fest. Andernfalls kann das Skript beendet und der Prozess beendet werden, bevor die Übertragung abgeschlossen wird.

Die Transfer-Methode hat keinen Rückgabewert. Nach Abschluss einer Übertragung sendet diese Methode ein OnTransferComplete-Ereignis an das Skript oder die Anwendung.

Beispiele

Im folgenden Beispiel wird die Verwendung der Transfer-Methode zum Übertragen von Daten von einem Gerät veranschaulicht.

<SCRIPT LANGUAGE="VBScript">
Dim objWia
Dim objDeviceInfoCollection
Dim objDeviceInfo
Dim objRootItem
Dim objSelectedItems
Dim objItem
 
Set objWIA = CreateObject("Wia.Script")
 
Set objDeviceInfoCollection = objWia.Devices
 
For Each objDeviceInfo In objDeviceInfoCollection
    Set objRootItem = objWia.Create(objDeviceInfo)
    Set objSelectedItems = objRootItem.GetItemsFromUI(0, 0)
    For Each objItem In objSelectedItems
        objItem.Transfer("c:\Folder\Filename.bmp")
    Next
Next
</SCRIPT>

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional, nur Windows [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
Wiascr.dll (Version 4.90 oder höher)