OBEXSendFile (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Location of the copied file
Transferring files by infrared
Limitation

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

OBEXSendFile (Function)

In french: OBEXEnvoieFichier

Sends a file to a device that supports the OBEX protocol.

Example

// Bluetooth connection
IF BTConnectDevice(COL_ID, "123") = True THEN
// OBEX connection
nIDOBEXCnt = OBEXConnect(obexBluetooth, COL_MAC)
// Transfer the file
TABLE_DEVICES[TABLE_DEVICES].BackgroundColor = ...
SWITCH (OBEXSendFile(nIDOBEXCnt, sFile), ...
White, PastelRed)
// End of transfer
OBEXDisconnect(nIDOBEXCnt)
ELSE
Error("Unable to connect to " + COL_DEVICE, ErrorInfo())
END

Syntax

<Result> = OBEXSendFile(<Identifier of OBEX connection> , <Local file path> [, <Remote file path>])

<Result>: Boolean

True if the transfer was successful,
False otherwise. ErrorInfo returns more details about the problem.
Caution: The sender is not notified if the file is refused by the remote computer: ErrorInfo contains no specific error code. The ErrorInfo function contains only error messages concerning the transmission.

<Identifier of OBEX connection>: Integer

Identifier of OBEX connection to use. This identifier is returned by OBEXConnect.

<Local file path>: Character string (with quotes)

Name and full path of the file to send.

<Remote file path>: Optional character string (with quotes)

Name and path of the file on the remote device. If this parameter is not specified, the file keeps the same name and it is copied into the transfer directory configured on the OBEX device.

Remarks

Location of the copied file

The file is copied into the transfer directory configured on the OBEX device used. If <Remote File Path> is specified, the specified path will be relative to the transfer directory.

Transferring files by infrared

When transferring files by infrared, the transfer is completed once OBEXSendFile has been run. However, Windows keep the transfer window opened (to manage a possible new file transfer). This window is only closed when disconnecting (OBEXDisconnect).

Limitation

Only the Microsoft bluetooth stacks are supported by this function. To find out which battery is in use, use the BTStack function.

See Which stacks to use? for more details

Component: wd260com.dll