Add Query() support to FileRef

ppapi/cpp/file_ref.h

 // Copyright (c) 2011 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_REF_H_
 #define PPAPI_CPP_FILE_REF_H_
 
+#include "ppapi/c/pp_file_info.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ppapi/c/ppb_file_ref.h"
 #include "ppapi/cpp/resource.h"
 #include "ppapi/cpp/var.h"
 
 /// @file
 /// This file defines the API to create a file reference or "weak pointer" to a
 /// file in a file system.
 
 namespace pp {
 
+class FileSystem;
 class CompletionCallback;
-class FileSystem;
+template<typename T> class CompletionCallbackWithOutput;

[dmichael (off chromium), 2013/03/27 20:20:06]

nit: I think there should be a space between "template" and "<"

 
 /// The <code>FileRef</code> class represents a "weak pointer" to a file in
 /// a file system.
 class FileRef : public Resource {
  public:
   /// Default constructor for creating an is_null() <code>FileRef</code>
   /// object.
   FileRef() {}
 
   /// A constructor used when you have an existing PP_Resource for a FileRef
@@ skipping 105 matching lines @@
   /// error to rename a file or directory that is in use.  It is not valid to
   /// rename a file in the external file system.
   ///
   /// @param[in] new_file_ref A <code>FileRef</code> corresponding to a new
   /// file reference.
   /// @param[in] cc A <code>CompletionCallback</code> to be called upon
   /// completion of Rename().
   ///
   /// @return An int32_t containing an error code from <code>pp_errors.h</code>.
   int32_t Rename(const FileRef& new_file_ref, const CompletionCallback& cc);
+
+  ///
+  /// Query() queries info about a file or directory. You must have access to
+  /// read this file or directory if it exists in the external filesystem.
+  ///
+  /// @param[in] callback A <code>CompletionCallbackWithOutput</code>
+  /// to be called upon completion of Query().
+  ///
+  /// @return An int32_t containing an error code from <code>pp_errors.h</code>.
+  int32_t Query(const CompletionCallbackWithOutput<PP_FileInfo>& callback);
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_FILE_REF_H_