System

Special purpose functions for operating system depending information. More...

Functions
LONG	TFormer_RefreshOSPrinters (HTFORM pInstance)
	Refreshes the internal list of (operating system) printers available for the current user.
LONG	TFormer_GetOSPrintersCount (HTFORM pInstance)
	Returns the number of (operating system) printers available for the current user.
LPCSTR	TFormer_GetOSPrinter (HTFORM pInstance, LONG nIndex)
	Returns the name of the (operating system) printer with the specified index.
LPCSTR	TFormer_GetOSDefaultPrinter (HTFORM pInstance)
	Returns the name of the default (operating system) printer of the current user.

---

Detailed Description

Special purpose functions for operating system depending information.

---

Function Documentation

LPCSTR TFormer_GetOSDefaultPrinter

(

HTFORM

pInstance

)

Returns the name of the default (operating system) printer of the current user.

If the internal structures are not initialized, this function will call TFormer_RefreshOSPrinters automatically.

Returns:

The name of the default (operating system) printer for the current user

Parameters:

pInstance

The TFORMer instance provided by a previous call to TFormer_Init

See also:

TFormer_RefreshOSPrinters, TFormer_GetOSPrintersCount, TFormer_GetOSPrinter

LPCSTR TFormer_GetOSPrinter	(	HTFORM	pInstance,
		LONG	nIndex
	)

Returns the name of the (operating system) printer with the specified index.

The index must be in the range [0...TFormer_GetOSPrintersCount]. If the internal structures are not initialized, this function will call TFormer_RefreshOSPrinters automatically.

Returns:

The name of the (operating system) printer

Parameters:

pInstance	The TFORMer instance provided by a previous call to TFormer_Init
nIndex	The index of the printer [0..TFormer_GetOSPrintersCount - 1]

See also:

TFormer_RefreshOSPrinters, TFormer_GetOSPrintersCount, TFormer_GetOSDefaultPrinter

LONG TFormer_GetOSPrintersCount

(

HTFORM

pInstance

)

Returns the number of (operating system) printers available for the current user.

If the internal structures are not initialized, this function will call TFormer_RefreshOSPrinters automatically.

Returns:

Number of (operating system) printers [0..n]

Parameters:

pInstance

The TFORMer instance provided by a previous call to TFormer_Init

See also:

TFormer_RefreshOSPrinters, TFormer_GetOSPrinter, TFormer_GetOSDefaultPrinter

LONG TFormer_RefreshOSPrinters

(

HTFORM

pInstance

)

Refreshes the internal list of (operating system) printers available for the current user.

Fills the internal structures for providing information about installed operating system printers.

Returns:

ErrOk (0) in case of success, non-zero if an error occurred

Parameters:

pInstance

The TFORMer instance provided by a previous call to TFormer_Init

See also:

TFormer_GetOSPrintersCount, TFormer_GetOSPrinter, TFormer_GetOSDefaultPrinter