UpdateSpecific Method (UtilHistory)

• Visual Basic
• C#

'Declaration
 
Public Shared Sub UpdateSpecific( _
   ByVal sessionId As Integer, _
   ByVal entityId As Integer, _
   ByVal eventTimeUtc As Date, _
   ByVal reasonCode As Nullable(Of Integer), _
   ByVal reasonPending As Nullable(Of Boolean), _
   ByVal comments As DBString, _
   ByVal rawReasonCode As DBString, _
   ByVal spare1 As DBString, _
   ByVal spare2 As DBString, _
   ByVal spare3 As DBString, _
   ByVal spare4 As DBString, _
   ByVal category1 As DBString, _
   ByVal category2 As DBString, _
   ByVal category3 As DBString, _
   ByVal category4 As DBString, _
   ByRef lastEditAt As Nullable(Of Date), _
   ByRef recordsAffected As Nullable(Of Integer) _
) 

'Usage
 
Dim sessionId As Integer
Dim entityId As Integer
Dim eventTimeUtc As Date
Dim reasonCode As Nullable(Of Integer)
Dim reasonPending As Nullable(Of Boolean)
Dim comments As DBString
Dim rawReasonCode As DBString
Dim spare1 As DBString
Dim spare2 As DBString
Dim spare3 As DBString
Dim spare4 As DBString
Dim category1 As DBString
Dim category2 As DBString
Dim category3 As DBString
Dim category4 As DBString
Dim lastEditAt As Nullable(Of Date)
Dim recordsAffected As Nullable(Of Integer)
 
UtilHistory.UpdateSpecific(sessionId, entityId, eventTimeUtc, reasonCode, reasonPending, comments, rawReasonCode, spare1, spare2, spare3, spare4, category1, category2, category3, category4, lastEditAt, recordsAffected)

public static void UpdateSpecific( 
   int sessionId,
   int entityId,
   DateTime eventTimeUtc,
   Nullable<int> reasonCode,
   Nullable<bool> reasonPending,
   DBString comments,
   DBString rawReasonCode,
   DBString spare1,
   DBString spare2,
   DBString spare3,
   DBString spare4,
   DBString category1,
   DBString category2,
   DBString category3,
   DBString category4,
   ref Nullable<DateTime> lastEditAt,
   out Nullable<int> recordsAffected
)

Parameters

sessionId

Required. Holds the session ID and thus the user who is making this method call.

entityId

Required. Holds the ID of the entity whose utilization event is being updated.

eventTimeUtc

Required. Holds the date/time in UTC for the start time of the utilization event that is being updated. This parameter, along with the entity ID, is used to identify the event record.

reasonCode

Optional. Holds the code that identifies the reason for the utilization event.

reasonPending

Optional. Holds a flag that indicates whether or not the reason is pending and needs to be finalized.

comments

Optional. Holds text to describe the event.

rawReasonCode

Optional. Holds the code that identifies the raw reason that is used to determine the utilization reason.

spare1

Optional. Holds the contents of the user-defined spare1 field.

spare2

Optional. Holds the contents of the user-defined spare2 field.

spare3

Optional. Holds the contents of the user-defined spare3 field.

spare4

Optional. Holds the contents of the user-defined spare4 field.

category1

Optional. Holds a user defined field that describes category1.

category2

Optional. Holds a user defined field that describes category2.

category3

Optional. Holds a user defined field that describes category3.

category4

Optional. Holds a user defined field that describes category4.

lastEditAt

Output. Holds the returned date/time when this record was added. The lastEditAt parameter is used by other methods that modify or delete this record for optimistic concurrency control.

recordsAffected

Output. Holds the number of records affected.