audit_8h_source.html

/*==============================================================================

                Copyright (c) 2003-2005 UGS Corporation

                   Unpublished - All Rights Reserved

 ==============================================================================*/


/*  */


#ifndef AUDIT_H

#define AUDIT_H


#include <qry/qry.h>

#include <tc/tc_startup.h>

#include <tccore/workspaceobject.h>

#include <tccore/item.h>

#include <stdarg.h>

#include <ss/ss_const.h>

#include <sa/tccalendar.h>

#include <sa/libsa_exports.h>


#define  AUDIT_equal                   0

#define  AUDIT_not_equal               1

#define  AUDIT_less_than               2

#define  AUDIT_less_than_or_equal      3

#define  AUDIT_greater_than            4

#define  AUDIT_greater_than_or_equal   5

#define  AUDIT_like                    6

#define  AUDIT_in                      7


typedef struct AUDIT_log_query_s {

    tag_t      objectTag;

    int        objectOperator;

    tag_t      eventTypeTag;

    int        eventTypeOperator;

    char*      id;

    int        idOperator;

    char*      name;

    int        nameOperator;

    char*      rev;

    int        revOperator;

    char*      puid;

    int        puidOperator;

    char*      userId;

    int        userIdOperator;

    date_t*    beforeDate;

    int        beforeDateOperator;

    date_t*    afterDate;

    int        afterDateOperator;

    char*      eventTypeName;

    int        eventTypeNameOperator;

    char*      groupName;

    int        groupNameOperator;

    tag_t      groupTag;

    int        groupTagOperator;

    char*      objSeqNumber;

    int        objSeqNumberOperator;

    char*      objTypeName;

    int        objTypeNameOperator;

    tag_t      secObjectTag;

    int        secObjectTagOperator;

    char*      secObjId;

    int        secObjIdOperator;

    char*      secObjName;

    int        secObjNameOperator;

    char*      secObjRev;

    int        secObjRevOperator;

    char*      secObjTypeName;

    int        secObjTypeNameOperator;

    char*      secObjSeqNumber;

    int        secObjSeqNumberOperator;

    char*      errorCode;

    int        errorCodeOperator;

    char*      errorMsg;

    int        errorMsgOperator;

    char*      projectName;

    char*      projectId;

    char*      projectUid;

    int        projectUidOperator;

} AUDIT_log_query_t;


typedef struct AUDIT_record_s {

    char       objTagStr[15];

    char       objName[TCCALENDAR_name_size_c + 1];

    char       id[ITEM_id_size_c + 1];

    char       revName[33];

    int        objSeqNumber;

    char       objTypeName[33];

    char       eventTypeTagStr[15];

    char       eventTypeName[33];

    char       auditDefTagStr[15];

    char       userId[33];

    char       groupTagStr[15];

    char       groupName[257];

    char       secObjTagStr[15];

    char       secObjName[TCCALENDAR_name_size_c + 1];

    char       secObjId[ITEM_id_size_c + 1];

    char       secObjRevName[33];

    int        secObjSeqNumber;

    char       secObjTypeName[33];

    char*      dateStr;

    int        errorCode;

    char       errorMsg[257];

    int        storageType;

    int        propCount;

    char**     propNames;

    char**     propValues;

    char**     propOldValues;

} AUDIT_record_t;


#ifdef __cplusplus

        extern "C"{

#endif


extern SA_API int AUDIT_log_event (

    tag_t         targetObject,

    tag_t         objectType,

    tag_t         eventType,

    const char*   objectId,

    const char*   objectName,

    const char*   rev

    );


extern SA_API int AUDIT_log_event2 (

    tag_t         targetObject,

    tag_t         objectType,

    tag_t         eventType,

    tag_t         subEventType,

    const char*   objectId,

    const char*   objectName,

    const char*   rev

    );


extern SA_API int AUDIT_log_event3 (

    tag_t         targetObject,

    tag_t         objectType,

    tag_t         eventType,

    tag_t         subEventType,

    const char*   objectId,

    const char*   objectName,

    const char*   rev,

    int           objectSeq,

    tag_t         secondaryObject,

    int           paramCount,

    const char**  paramNames,

    const char**  paramValues,

    int           errorCode,

    const char*   errorMsg

    );


extern SA_API int AUDIT_log_event4 (

    tag_t         targetObject,

    tag_t         objectType,

    tag_t         eventType,

    tag_t         subEventType,

    const char*   objectId,

    const char*   objectName,

    const char*   rev,

    int           objectSeq,

    int           secondaryObjectTagCount,

    tag_t*        secondaryObjectTags,

    const char**  secondaryObjectQualifiers,

    int           paramCount,

    const char**  paramNames,

    const char**  paramValues,

    int           errorCode,

    const char*   errorMsg

    );


extern SA_API int AUDIT_get_records (

    AUDIT_log_query_t       logQuery,

    int                     nConditions,

    char**                  conditionValues,

    int*                    resColCount,

    char***                 resColNames,

    QRY_user_query_row_t**  resRows

    );


extern SA_API int AUDIT_get_records_with_specified_col (

    AUDIT_log_query_t       logQuery,

    int                     nConditions,

    char**                  conditionValues,

    int                     resColCount,

    char**                  resColNames,

    QRY_user_query_row_t**  resRows

    );


extern SA_API int AUDIT_get_records_with_specified_col2 (

    AUDIT_log_query_t       logQuery,

    int                     nConditions,

    char**                  conditionPropNames,

    char**                  conditionValues,

    int                     resColCount,

    char**                  resColNames,

    QRY_user_query_row_t**  resRows

    );


extern SA_API int AUDIT_delete_specified_records (

    int           logCount,

    char**        logUidis

    );


extern SA_API int AUDIT_delete_records (

    AUDIT_log_query_t   logQuery

    );


extern SA_API int AUDIT_insert_record (

    AUDIT_record_t  logInfo

    );


extern SA_API void  AUDIT_initialize_log_query (

    AUDIT_log_query_t*  logQuery

    );


#ifdef __cplusplus

}

#endif


#include <sa/libsa_undef.h>


#endif