PESetNthTableLogOnInfo
Use PESetNthTableLogOnInfo to set the log on information for the specified print job to the values in PELogOnInfo.
C Syntax
BOOL CRPE_API PESetNthTableLogOnInfo (
short printJob,
short tableN,
PELogOnInfo FAR *logOnInfo,
BOOL propagateAcrossTables );
Parameters
printJob
| Specifies the print job for which you want to set table log on information.
|
tableN
| Specifies the 0-based number of the table for which you want to set log on information. The first table is table 0. The last table is N-1.
|
logOnInfo
| Specifies a pointer to the PELogOnInfo.
|
propagateAcrossTables
| If set to TRUE, the program will apply the new log on information to any other tables in the report that had the same original server and database names as the specified table. If set to FALSE, the program will apply the new log on information only to the table specified.
|
Returns
- TRUE if the call is successful.
- FALSE if the call fails.
Remarks
- See PELogOnServer for additional comments regarding PELogOnInfo.
- The program logs on when printing the report, but you must first set the correct log on information using PESetNthTableLogOnInfo. Logging off is performed automatically when the print job is closed.
- You must supply at least the password with this function. You can pass empty strings ("") for the other parameters or, alternatively, you can change the server, database, and/or user ID by entering the appropriate strings.
- When you create a report from a single database (for example, one .MDB file with multiple tables), set the propagateAcrossTables parameter to TRUE. This insures that the changes are made to all tables in the .MDB file (thus avoiding the necessity to code the changes for each table individually).
- This function can be used to set the location of an Essbase application and database used by a report. For complete information, see PELogOnInfo.
VB Syntax
Declare Function PESetNthTableLogOnInfo Lib "crpe32.dll" ( ByVal
printJob As Integer, ByVal TableN As Integer, LogOnInfo As PELogOnInfo,
ByVal Propagate As Integer ) As Integer
Delphi Syntax
function PESetNthTableLogOnInfo (
printJob: Word;
tableN: smallint;
var logOnInfo: PELogOnInfo;
propagateAcrossTables: Bool
): Bool stdcall;