Método Item.Transfer

O método Transfer do objeto Item transfere dados de um dispositivo para um arquivo. Esse método se aplica somente a itens de tipo de dispositivo.

Sintaxe

Item.Transfer(
  Filename,
  AsyncTransfer = VARIANT_BOOL
)

Parâmetros

Nome do arquivo [in]

Tipo: BSTR

Especifica o nome do arquivo para o qual os dados são transferidos.

AsyncTransfer [in]

Tipo: VARIANT_BOOL

Um valor booliano que especifica se a transferência deve ser executada como uma chamada assíncrona.

(VARIANT_BOOL)

Padrão. Defina esse valor como true se a chamada deve ser assíncrona (consulte Comentários).

Valor retornado

Esse método não retorna um valor.

Comentários

Esse método se aplica somente a itens de tipo de arquivo. O método verifica se o item dá suporte a esse método antes de tentar concluir a transferência de dados.

Use "área de transferência" como o parâmetro Filename para transferir um item para a área de transferência.

Defina o valor AsyncTransfer como false para transferências em qualquer aplicativo ou script executado em um ambiente que encerre um processo no final de um script, como o WSH (Host de Script do Windows). Caso contrário, o script poderá terminar e o processo será encerrado antes da conclusão da transferência.

O método Transfer não tem nenhum valor retornado. Após a conclusão de uma transferência, esse método envia um evento OnTransferComplete para o script ou aplicativo.

Exemplos

O exemplo a seguir demonstra o uso do método Transfer para transferir dados de um dispositivo.

<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>

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
DLL	Wiascr.dll (versão 4.90 ou posterior)