SE_log_open_log

Opens a log file 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 log file
Description

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

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

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

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

SE_OUTPUT_NO_DELETE_MODE—Creates and opens a new log file. If the log file 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 user name to simultaneously open the same log file. 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.