Click above to get retro games delivered to your door ever month!

 CapBannerNameGet() / CapBannerNameSet()
------------------------------------------------------------------------------
 Purpose:
 Get or set the capture banner name.

 Syntax:
 lpszBanNme = CapBannerNameGet()
 lpszBanNme = CapBannerNameSet( lpszNewBannerName )

 Parameters:
 lpszNewBannerName The new banner name.

 Returns:
 A character string of length 12.

 The CA-Clipper names for these functions:
 CapBanNmeGet() / CapBanNmeSet()

 Description:
 CapBannerNameGet() returns the name printed on banners preceding print
 jobs.

 CapBannerNameSet() sets the name to the specified value lpszNewBannerName
 and returns the name that was previously set.

 Returns an empty string if there is no banner text set, or if an error
 occurs.

 Example:
 // To set the banner name to the current user's name:
 lpszUserName = WSLoginNameGet( WSConnNumberGet() )
 lpszOldBannerName = CapBannerNameSet(lpszUserName)
 lpszNewBannerName = CapBannerNameGet()
 if ( !empty( lpszNewBannerName ) )
    ? "Banner name set to", lpszNewBannerName
 endif

 Notes:
 If an empty string is returned, check NWErrorGet().