EDK: Add HandleTable::AddHandleVector().

mojo/edk/system/handle_table.h

 // Copyright 2014 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 MOJO_EDK_SYSTEM_HANDLE_TABLE_H_
 #define MOJO_EDK_SYSTEM_HANDLE_TABLE_H_
 
 #include <stddef.h>
 
 #include <unordered_map>
@@ skipping 56 matching lines @@
   // full).
   MojoHandle AddHandle(Handle&& handle);
 
   // Adds a pair of handles (both of which must be valid), returning a pair of
   // handle values for them. On failure (if the handle table is full), the
   // (first and second) handle values will be |MOJO_HANDLE_INVALID|, and neither
   // dispatcher will be added.
   std::pair<MojoHandle, MojoHandle> AddHandlePair(Handle&& handle0,
                                                   Handle&& handle1);
 
-  // Adds the given vector of dispatchers (of size at most
+  // Adds the given vector of handles (of size at most
   // |kMaxMessageNumHandles|). |handle_values| must point to an array of size at
-  // least |dispatchers.size()|. Unlike the other |AddDispatcher...()|
-  // functions, some of the dispatchers may be invalid (null). Returns true on
-  // success and false on failure (if the handle table is full), in which case
-  // it leaves |handle_values[...]| untouched (and all dispatchers unadded).
+  // least |handles->size()|. Unlike the other |AddHandle...()| functions, some
+  // of the handles may be invalid ("null"). Returns true on success in which
+  // case all the handles in |*handles| are moved from, and false on failure (if
+  // the handle table is full), in which case it leaves all |handles->at(...)||
+  // (and all the handles unadded) and |handle_values[...]| untouched.
+  bool AddHandleVector(HandleVector* handles, MojoHandle* handle_values);
+  // TODO(vtl): Delete this version (use |AddHandleVector()| instead).
   bool AddDispatcherVector(const DispatcherVector& dispatchers,
                            MojoHandle* handle_values);
 
   // Tries to mark the given handle values as busy and start transport on them
   // (i.e., take their dispatcher locks); |transports| must be sized to contain
   // |num_handles| elements. On failure, returns them to their original
   // (non-busy, unlocked state).
   MojoResult MarkBusyAndStartTransport(
       MojoHandle disallowed_handle,
       const MojoHandle* handle_values,
@@ skipping 48 matching lines @@
   HandleToEntryMap handle_to_entry_map_;
   MojoHandle next_handle_value_;  // Invariant: never |MOJO_HANDLE_INVALID|.
 
   MOJO_DISALLOW_COPY_AND_ASSIGN(HandleTable);
 };
 
 }  // namespace system
 }  // namespace mojo
 
 #endif  // MOJO_EDK_SYSTEM_HANDLE_TABLE_H_