[go: nahoru, domu]

blob: 96c1b0b423c1ed848c1f9255874a9e841b5cb1cc [file] [log] [blame]
// Copyright 2015 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 IPC_HANDLE_WIN_H_
#define IPC_HANDLE_WIN_H_
#include <windows.h>
#include <string>
#include "ipc/ipc_export.h"
#include "ipc/ipc_param_traits.h"
namespace base {
class Pickle;
class PickleIterator;
} // namespace base
namespace IPC {
// HandleWin is a wrapper around a Windows HANDLE that can be transported
// across Chrome IPC channels that support attachment brokering. The HANDLE will
// be duplicated into the destination process.
//
// The ownership semantics for the underlying |handle_| are complex. See
// ipc/mach_port_mac.h (the OSX analog of this class) for an extensive
// discussion.
class IPC_EXPORT HandleWin {
public:
enum Permissions {
// A placeholder value to be used by the receiving IPC channel, since the
// permissions information is only used by the broker process.
INVALID,
// The new HANDLE will have the same permissions as the old HANDLE.
DUPLICATE,
// The new HANDLE will have file read and write permissions.
FILE_READ_WRITE,
MAX_PERMISSIONS = FILE_READ_WRITE
};
// Default constructor makes an invalid HANDLE.
HandleWin();
HandleWin(const HANDLE& handle, Permissions permissions);
HANDLE get_handle() const { return handle_; }
void set_handle(HANDLE handle) { handle_ = handle; }
Permissions get_permissions() const { return permissions_; }
private:
HANDLE handle_;
Permissions permissions_;
};
template <>
struct IPC_EXPORT ParamTraits<HandleWin> {
typedef HandleWin param_type;
static void Write(base::Pickle* m, const param_type& p);
static bool Read(const base::Pickle* m,
base::PickleIterator* iter,
param_type* p);
static void Log(const param_type& p, std::string* l);
};
} // namespace IPC
#endif // IPC_HANDLE_WIN_H_