SE_log_open_log

Opens a logfile for processing.

Usage syntax

LONG SE_log_open_log (SE_CONNECTION connection, const SE_LOGINFO loginfo, LONG mode, SE_LOG *log);

Parameters
connection The connection handle
loginfo The SE_LOGINFO object
mode The mode to use when the file is opened
log The file handle to use when referencing this logfile
Description

SE_log_open_log opens a logfile in the specified mode on the ArcSDE server. This call is required to get a valid logfile handle for subsequent logfile operations. This function can create or open a logfile on a layer or a registered table. The obsolete function SE_log_open can create logfile on layers only. The following logfile modes are supported:

SE_INPUT_MODE Opens a logfile in read-only mode. The logfile can be owned by any user.

SE_OUTPUT_MODE Creates and opens a new logfile if one does not exist; otherwise, opens the existing logfile. Any entries in an existing logfile are deleted. The logfile must be owned by the current user.

SE_EXTEND_MODE Opens an existing logfile and appends to it. The logfile must exist and be owned by the current user.

SE_OUTPUT_NO_DELETE_MODE Creates and opens a new logfile. If the logfile already exists, returns an SE_LOG_IO_ERROR error.

Returns

SE_SUCCESS
SE_FAILURE

SE_DB_IO_ERROR

SE_INVALID_PARAM_VALUE

SE_INVALID_POINTER

SE_LOG_IO_ERROR

SE_LOG_NOEXIST

SE_NET_FAILURE

SE_NO_PERMISSIONS

SE_OUT_OF_SVMEM

SE_SDE_NOT_STARTED

SE_TABLE_NOEXIST

Notes

• Due to operating system limitations, it may be possible for two ArcSDE sessions of the same username to simultaneously open the same logfile. Therefore, it is possible that the edits of one session may overwrite those of another. You can avoid this by using SE_log_make_name.