getValueEx Method
Returns the value of the field at the specified position in the record.
The value returned by the getValueEx method is intended for low-level programming languages and is not suitable for
consumption by scripting languages.
C++ Syntax
HRESULT getValueEx(IN VARIANT *pindexOrName, OUT VARIANT *pVal);
Parameters
- pindexOrName
- A VT_I4 or VT_BSTR VARIANT containing either the 0-based index
of the field in the query output records, or the name of the field in the query output
records.
The index must be less than the number of fields returned by the getColumnCount method of the LogRecordSet object.
Return Value
The value of the specified field.The value is returned as a VARIANT whose type depends on the data type of the field. The following table shows the VARIANT type returned for each of the Log Parser data types:
| Field Type | VARIANT Type | Description |
|---|---|---|
| INTEGER | VT_I8 | 64-bit integer |
| REAL | VT_R8 | 64-bit floating-point number |
| STRING | VT_BSTR | String |
| TIMESTAMP | VT_I8 | 64-bit integer representing the number of 100-nanosecond intervals since January 1, year 0 |
| NULL | VT_NULL | VT_NULL VARIANT |
Remarks
- The getValueEx method returns 64-bit integer values that are not handled correctly by scripting languages, For this reason, the method is intended for use by low-level, non-scripting languages, such as C++. If you are developing an application using scripting languages, consider using the getValue method instead.
See also:
LogRecord ObjectgetValue Method
Log Parser COM API Overview
C# Example