PELogOnInfo
PELogOnInfo contains log on information that is used by PEGetNthTableLogOnInfo; PESetNthTableLogOnInfo; PELogOnServer; and PELogOffServer for logging on and off SQL and password-protected non-SQL databases.
C Syntax
typedef struct PELogOnInfo {
WORD StructSize;
char ServerName [PE_SERVERNAME_LEN];
char DatabaseName [PE_DATABASENAME_LEN];
char UserID [PE_USERID_LEN];
char Password [PE_PASSWORD_LEN];
} PELogOnInfo;
Members
StructSize
| Specifies the size of the PELogOnInfo structure. Initialize this member to PE_SIZEOF_LOGON_INFO.
|
ServerName
| Specifies the logon name for the server (of length PE_SERVERNAME_LEN = 128, NULL-terminated) used to create the report. See Remarks below.
|
DatabaseName
| Specifies the database logon name (of length PE_DATABASENAME_LEN = 128, NULL-terminated) for the database used to create the report. See Remarks below.
|
UserID
| Specifies the user I.D (of length PE_USERID_LEN = 128, NULL-terminated) necessary to log on to the server. See Remarks below.
|
Password
| Specifies the password (of length PE_PASSWORD_LEN = 128, NULL-terminated) necessary to log on to the server. See Remarks below.
|
Remarks
- All strings must be null-terminated.
- Password is undefined when getting information from the report.
- Password must be set using PEGetNthTableLogOnInfo. You can pass an empty string ("") for ServerName, DatabaseName, or UserID, and the program will use the value that's already set in the report. If you want to override a value that's already set in the report, use a non-empty string (for example, "Server A") for the other parameters as well.
- For Netware SQL, pass the dictionary path name in member ServerName and data path name in member DatabaseName.
- If your report uses a Microsoft Access database via ODBC, the data source indicated in the ServerName parameter must specify an Access database file. An ODBC data source based on the Access driver with no database specified cannot be used at runtime.
- For Essbase databases, pass the Essbase application and database to the DatabaseName member with a comma between each. For example:
Sample,Basic
VB Type Listing
Type PELogOnInfo
StructSize As Integer
ServerName As String * PE_SERVERNAME_LEN
DatabaseName As String * PE_DATABASENAME_LEN
UserID As String * PE_USERID_LEN
Password As String * PE_PASSWORD_LEN
End Type
Delphi Record Listing
type
PELogonServerType = array[0..PE_SERVERNAME_LEN-1] of char;
PELogonDBType = array[0..PE_DATABASENAME_LEN-1] of char;
PELogonUserType = array[0..PE_USERID_LEN-1] of char;
PELogonPassType = array[0..PE_PASSWORD_LEN-1] of char;
PELogOnInfo = record
StructSize: Word;
ServerName: PELogonServerType;
DatabaseName: PELogonDbType;
UserId: PELogonUserType;
Password: PELogonPassType;
end;