PrintTextBuffer

int PrintTextBuffer (char buffer[], char outputFile[]);

Purpose

Prints the contents of a text buffer. You can direct the output to the printer or to a file. If you pass an empty string ("") to the outputFile parameter, this function prints the contents of the text buffer to the default printer.

When you print the text buffer, the following occurs:

While this function is printing, it blocks any other thread in your program that attempts to print.

Remember that LabWindows/CVI maintains only one copy of the print attributes you set with SetPrintAttribute. Thus, when you change a print attribute in one thread, the change affects printing functions you subsequently call in other threads.

Parameters

Input
Name Type Description
buffer string Text to print. Must be terminated by an ASCII NUL byte.
outputFile string Name of the output file. If the name is not empty, the output is redirected to the file. If you pass an empty string (""), this function prints the contents of the text buffer to the default printer.

If outputFile is a not a complete pathname, it is created relative to the current working directory.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success