Provide a safer URLLoader ReadResponseBody API

ppapi/cpp/file_io.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef PPAPI_CPP_FILE_IO_H_
 #define PPAPI_CPP_FILE_IO_H_
 
 #include "ppapi/c/pp_time.h"
 #include "ppapi/cpp/completion_callback.h"
 #include "ppapi/cpp/resource.h"
@@ skipping 135 matching lines @@
   /// callback to queue up parallel reads from the file at different offsets.
   int32_t Read(int64_t offset,
                char* buffer,
                int32_t bytes_to_read,
                const CompletionCallback& cc);
 
   /// Read() reads from an offset in the file.  A PP_ArrayOutput must be
   /// provided so that output will be stored in its allocated buffer.  This
   /// function might perform a partial read.
   ///
-  /// @param[in] file_io A <code>PP_Resource</code> corresponding to a file
-  /// FileIO.
   /// @param[in] offset The offset into the file.
   /// @param[in] max_read_length The maximum number of bytes to read from
   /// <code>offset</code>.
-  /// @param[in] output A <code>PP_ArrayOutput</code> to hold the output data.
-  /// @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
-  /// completion of Read().
+  /// @param[in] cc A <code>CompletionCallbackWithOutput</code> to hold a
+  /// PP_ArrayOutput for output, and to be called upon completion of Read().
   ///
   /// @return The number of bytes read or an error code from
   /// <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
   /// reached. It is valid to call Read() multiple times with a completion
   /// callback to queue up parallel reads from the file, but pending reads
   /// cannot be interleaved with other operations.
   int32_t Read(int32_t offset,
                int32_t max_read_length,
                const CompletionCallbackWithOutput< std::vector<char> >& cc);
 
@@ skipping 60 matching lines @@
   // interface in 1.1.
   //
   // This takes a heap-allocated CallbackData1_0 struct passed as the user data
   // and deletes it when the call completes.
   static void CallbackConverter(void* user_data, int32_t result);
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_FILE_IO_H_