Export (0) Print
Expand All

GetNextChange method

Gets the next change record stored in the change log.

Syntax


HRESULT retVal = object.GetNextChange(pbBuffer, nBufferSize, pnRecordLength);

Parameters

pbBuffer [in]

Type: BYTE

A pointer to a variable of type BYTE that specifies the first byte of a caller-allocated buffer in which to store the record.

nBufferSize [in]

Type: long

A long integer that specifies the size of the caller-allocated buffer, in bytes.

pnRecordLength [out]

Type: long

A pointer to a variable of type long that receives the size of the record, in bytes.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method has two uses.

  • Get a change record
  • Determine the size of the buffer to allocate for the next record.

Change records vary in length and have no maximum length. IHTMLChangeLog::GetNextChange always gets the value for pnRecordLength, even if the method fails. If your buffer is too small, and this method returns S_FALSE, use the value in pnRecordLength to reallocate your buffer so that it is large enough for the next record, and then call IHTMLChangeLog::GetNextChange again.

If no further changes are pending, this method sets pnRecordLength to zero.

 

 

Community Additions

ADD
Show:
© 2014 Microsoft