Gets the next change record stored in the change log.
HRESULT retVal = object.GetNextChange(pbBuffer, nBufferSize, pnRecordLength);
- pbBuffer [in]
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]
A long integer that specifies the size of the caller-allocated buffer, in bytes.
- pnRecordLength [out]
A pointer to a variable of type long that receives the size of the record, in bytes.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
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.