There's a small code example here:
http://groups.google.com/group/phrets/msg/d16570387c3a2cb0?hl=en
but basically, imagine running an operation that just determined that there are 50 listings you need to retrieve updated photos for. Normally, you might have an array of 50 individual MLS#'s that you need to retrieve. You'd loop through that list like:
foreach ($listings_to_get as $listing) {
$photos = $rets->GetObject("Property", "Photo", $listing);
// then loop through the $photos to process each
}
When you use something like create_batch_list, you'd use a very similar loop:
$batches_to_get = create_batch_list($listings_to_get, 10);
foreach ($batches_to_get as $batch) {
$photos = $rets->GetObject("Property", "Photo", $batch);
// then loop through the $photos to process each
}
The 1 additional line for create_batch_list in the 2nd loop breaks your 50 item array into chunks of 10 items each. If you had 50 items to grab total, the first loop makes 50 individual GetObject requests. In the second example, it makes 5 GetObject requests total (each containing a request for 10 properties worth of photos).