moveNext Method

Advances the enumerator to the next LogRecord in the enumeration.

Script Syntax

objRecordSet.moveNext();

Return Value

None.

Remarks

• Depending on the query structure, calling the moveNext method can cause the query to further process new input records, which could in turn generate additional errors, parse errors, or warnings.
• If the moveNext method encounters errors, an exception is thrown containing the error message and code, and further processing is aborted.
  In this case, the lastError property of the LogRecordSet object is set to -1, and the collection of strings returned by the errorMessages property contains the error message.
• If the moveNext method encounters parse errors or warnings, the enumerator is advanced successfully, and the lastError property of the LogRecordSet object is set to -1. In this case, the collection of strings returned by the errorMessages property contains the parse error messages and/or warning messages.

Examples

JScript example:

var oLogQuery = new ActiveXObject("MSUtil.LogQuery");

// Create Input Format object
var oIISW3CInputFormat = new ActiveXObject("MSUtil.LogQuery.IISW3CInputFormat");

// Create query text
var strQuery = "SELECT c-ip FROM <1> WHERE cs-uri-stem LIKE '%hitcount.asp'";

// Execute query and receive a LogRecordSet
var oRecordSet = oLogQuery.Execute( strQuery, oIISW3CInputFormat );

// Visit all records
while( !oRecordSet.atEnd() )
{
	// Get a record
	var oRecord = oRecordSet.getRecord();

	// Get first field value
	var strClientIp = oRecord.getValue( 0 );

	// Print field value
	WScript.Echo( "Client IP Address: " + strClientIp );

	// Advance LogRecordSet to next record
	oRecordSet.moveNext();
}

// Close LogRecordSet
oRecordSet.close();

VBScript example:

Dim oLogQuery
Dim oIISW3CInputFormat
Dim strQuery
Dim oRecordSet
Dim oRecord
Dim strClientIp

Set oLogQuery = CreateObject("MSUtil.LogQuery")

' Create Input Format object
Set oIISW3CInputFormat = CreateObject("MSUtil.LogQuery.IISW3CInputFormat")

' Create query text
strQuery = "SELECT c-ip FROM <1> WHERE cs-uri-stem LIKE '%hitcount.asp'"

' Execute query and receive a LogRecordSet
Set oRecordSet = oLogQuery.Execute ( strQuery, oIISW3CInputFormat )

' Visit all records
DO WHILE NOT oRecordSet.atEnd

	' Get a record
	Set oRecord = oRecordSet.getRecord

	' Get first field value
	strClientIp = oRecord.getValue ( 0 )

	' Print field value
	WScript.Echo "Client IP Address: " & strClientIp

	' Advance LogRecordSet to next record
	oRecordSet.moveNext

LOOP

' Close RecordSet
oRecordSet.close

See also:

LogRecordSet Object
LogRecord Object
Log Parser COM API Overview
C# Example

---

© 2004 Microsoft Corporation. All rights reserved.