Utilities.FileWrite Method

Applies to TestComplete 15.70, last modified on December 17, 2024
This method is obsolete. See the Remarks section below.

Description

The Utilities.FileWrite method writes Count bytes from the Buffer to a file whose handle is specified by the Handle parameter. The file handle is returned by the FileCreate or FileOpen method.

Declaration

Utilities.FileWrite(Handle, Buffer, Count)

Handle [in]    Required    Integer    
Buffer [in]    Required    Variant    
Count [in]    Required    Integer    
Result Integer

Applies To

The method is applied to the following object:

Parameters

The method has the following parameters:

Handle

Specifies the handle of the desired file.

Buffer

Specifies the variable from which certain number of bytes will be written to the specified file.

Count

Specifies the number of bytes to be written to the specified file.

Result Value

The method returns the number of bytes that were written to the file successfully. This number may be less than Count. If an error occurs during the writing process, FileWrite returns -1.

Remarks

This method is obsolete. It is supported for backward compatibility only. To write to text and binary files, use the aqBinaryFile.Write and aqTextFile.Write methods, respectively.

See Also

aqBinaryFile Object Methods
Write Method
OpenBinaryFile Method
OpenTextFile Method
Cursor Property
Cursor Property

Highlight search results