Exposing the Close() method publicly in the ScopedHandle class....

base/scoped_handle_win.h

 // Copyright (c) 2006-2008 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 BASE_SCOPED_HANDLE_WIN_H_
 #define BASE_SCOPED_HANDLE_WIN_H_
 
 #include <windows.h>
 
 #include "base/basictypes.h"
 #include "base/logging.h"
 
-// Used so we always remember to close the handle. Example:
+// Used so we always remember to close the handle.
+// The class interface matches that of ScopedStdioHandle in  addition to an
+// IsValid() method since invalid handles on windows can be either NULL or
+// INVALID_HANDLE_VALUE (-1).
+//
+// Example:
 //   ScopedHandle hfile(CreateFile(...));
 //   if (!hfile.Get())
 //     ...process error
 //   ReadFile(hfile.Get(), ...);
 //
 // To sqirrel the handle away somewhere else:
 //   secret_handle_ = hfile.Take();
 //
 // To explicitly close the handle:
-//   CloseHandle(hfile.Take());
+//   hfile.Close();
 class ScopedHandle {
  public:
   ScopedHandle() : handle_(NULL) {
   }
 
   explicit ScopedHandle(HANDLE h) : handle_(NULL) {
     Set(h);
   }
 
   ~ScopedHandle() {
@@ skipping 20 matching lines @@
 
   operator HANDLE() { return handle_; }
 
   HANDLE Take() {
     // transfers ownership away from this object
     HANDLE h = handle_;
     handle_ = NULL;
     return h;
   }
 
- private:
   void Close() {
     if (handle_) {
       if (!::CloseHandle(handle_)) {
         NOTREACHED();
       }
       handle_ = NULL;
     }
   }
 
+ private:
   HANDLE handle_;
   DISALLOW_EVIL_CONSTRUCTORS(ScopedHandle);
 };
 
 // Like ScopedHandle, but for HANDLEs returned from FindFile().
 class ScopedFindFileHandle {
  public:
   explicit ScopedFindFileHandle(HANDLE handle) : handle_(handle) {
     // Windows is inconsistent about invalid handles, so we always use NULL
     if (handle_ == INVALID_HANDLE_VALUE)
@@ skipping 116 matching lines @@
  private:
   HGLOBAL glob_;
 
   T* data_;
 
   DISALLOW_EVIL_CONSTRUCTORS(ScopedHGlobal);
 };
 
 #endif // BASE_SCOPED_HANDLE_WIN_H_