Rejecting networks/certificates individually from ONC during validation.

chromeos/network/onc/onc_mapper.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 CHROMEOS_NETWORK_ONC_ONC_MAPPER_H_
 #define CHROMEOS_NETWORK_ONC_ONC_MAPPER_H_
 
 #include <string>
 
 #include "base/memory/scoped_ptr.h"
@@ skipping 24 matching lines @@
 // The ONC validator and normalizer derive from this class and adapt the default
 // copy behavior.
 class Mapper {
  public:
   Mapper();
   virtual ~Mapper();
 
  protected:
   // Calls |MapObject|, |MapArray| and |MapPrimitive| according to |onc_value|'s
   // type, which always return an object of the according type. Result of the
-  // mapping is returned. On error sets |error| to true.
+  // mapping is returned. Only on error sets |error| to true.
   virtual scoped_ptr<base::Value> MapValue(const OncValueSignature& signature,
                                            const base::Value& onc_value,
                                            bool* error);
 
   // Maps objects/dictionaries. By default calls |MapFields|, which recurses
   // into each field of |onc_object|, and drops unknown fields. Result of the
-  // mapping is returned. On error sets |error| to true. In this implementation
-  // only unknown fields are errors.
+  // mapping is returned. Only on error sets |error| to true. In this
+  // implementation only unknown fields are errors.
   virtual scoped_ptr<base::DictionaryValue> MapObject(
       const OncValueSignature& signature,
       const base::DictionaryValue& onc_object,
       bool* error);
 
   // Maps primitive values like BinaryValue, StringValue, IntegerValue... (all
   // but dictionaries and lists). By default copies |onc_primitive|. Result of
-  // the mapping is returned. On error sets |error| to true.
+  // the mapping is returned. Only on error sets |error| to true.
   virtual scoped_ptr<base::Value> MapPrimitive(
       const OncValueSignature& signature,
       const base::Value& onc_primitive,
       bool* error);
 
   // Maps each field of the given |onc_object| according to |object_signature|.
   // Adds the mapping of each field to |result| using |MapField| and drops
   // unknown fields by default. Sets |found_unknown_field| to true if this
-  // dictionary contains any unknown fields. Set |nested_error| to true if
+  // dictionary contains any unknown fields. Set |nested_error| to true only if
   // nested errors occured.
   virtual void MapFields(const OncValueSignature& object_signature,
                          const base::DictionaryValue& onc_object,
                          bool* found_unknown_field,
                          bool* nested_error,
                          base::DictionaryValue* result);
 
   // Maps the value |onc_value| of field |field_name| according to its field
   // signature in |object_signature| using |MapValue|. Sets
   // |found_unknown_field| to true and returns NULL if |field_name| cannot be
   // found in |object_signature|. Otherwise returns the mapping of |onc_value|.
   virtual scoped_ptr<base::Value> MapField(
       const std::string& field_name,
       const OncValueSignature& object_signature,
       const base::Value& onc_value,
       bool* found_unknown_field,
       bool* error);
 
   // Maps the array |onc_array| according to |array_signature|, which defines
   // the type of the entries. Maps each entry by calling |MapValue|. If any of
   // the nested mappings failed, the flag |nested_error| is set to true and the
-  // entry is dropped from the result. The resulting array is returned.
+  // entry is dropped from the result. Otherwise |nested_error| isn't
+  // modified. The resulting array is returned.
   virtual scoped_ptr<base::ListValue> MapArray(
       const OncValueSignature& array_signature,
       const base::ListValue& onc_array,
       bool* nested_error);
 
   // Calls |MapValue| and returns its result. Called by |MapArray| for each
   // entry and its index in the enclosing array.
   virtual scoped_ptr<base::Value> MapEntry(int index,
                                            const OncValueSignature& signature,
                                            const base::Value& onc_value,
                                            bool* error);
 
  private:
   DISALLOW_COPY_AND_ASSIGN(Mapper);
 };
 
 }  // namespace onc
 }  // namespace chromeos
 
 #endif  // CHROMEOS_NETWORK_ONC_ONC_MAPPER_H_