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.

Help / WLanguage / WLanguage functions / Communication / OBEX functions

Location of the copied file
Transferring files infrared ports
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

// Connexion Bluetooth
IF BTConnectDevice(COL_ID, "123") = True THEN
	// Connexion OBEX
	nIDCnxOBEX = OBEXConnect(obexBluetooth, COL_MAC)
	// Transfert du fichier
	TABLE_PERIPHERIQUES[TABLE_PERIPHERIQUES].CouleurFond = ...
				  SWITCH (OBEXSendFile(nIDCnxOBEX, sFichier), ...
						White, PastelRed)
	// Fin du transfert
	OBEXDisconnect(nIDCnxOBEX)
ELSE
	 Error("Impossible de se connecter à " + COL_PERIPHERIQUE, 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 information on the error.
Attention: If the file is refused by the remote machine, the sender is not informed: the ErrorInfo function contains no specific error.. ErrorInfo only contains the transmission error messages.

<Identifier of OBEX connection>: Integer

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

<Local file path>: Character string

Name and full path of the file to send.

<Remote file path>: Optional character string

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

When files are transfered via infrared ports, the transfer is completed once OBEXSendFile has been executed. 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 get the stack used, call BTStack.

For more details, see Which stacks to use?

Component: wd300com.dll