Merge 21437 - CPAPI (0.11) for gears drag drop....

chrome/common/chrome_plugin_api.h

-// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.
+// Copyright (c) 2009 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.
 //
 // This header specifies the Chrome Plugin API.  It is based heavily on NPAPI.
 // The key difference is that Chrome plugins can be loaded for the lifetime
 // of the browser, and are not tied to a specific web page.
 //
 // NOTE: This API is not final and may change or go away at any point.
 //
 // All strings in the API are UTF8-encoded unless otherwise noted.
@@ skipping 11 matching lines @@
 #endif // WIN32
 #endif // STDCALL
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 // The current version of the API, used by the 'version' field of CPPluginFuncs
 // and CPBrowserFuncs.
 #define CP_MAJOR_VERSION 0
-#define CP_MINOR_VERSION 10
+#define CP_MINOR_VERSION 11
 #define CP_VERSION       ((CP_MAJOR_VERSION << 8) | (CP_MINOR_VERSION))
 
 #define CP_GET_MAJOR_VERSION(version) ((version & 0xff00) >> 8)
 #define CP_GET_MINOR_VERSION(version) (version & 0x00ff)
 
 typedef unsigned char CPBool;
 
 // Chrome plugins can be loaded into different process types.
 typedef enum {
   CP_PROCESS_BROWSER = 0,
@@ skipping 394 matching lines @@
 // so-called "copy" and "none" effects.  When 'effect' is non-zero, the "copy"
 // effect is shown.  Otherwise, the "none" effect is shown, which prevents the
 // subsequent drop event from succeeding.  Returns CPError on failure, meaning
 // the 'event' is an invalid drag event.
 //
 // Note: 'effect' is int to allow for new effects in future.  For example, the
 // HTML5-defined drop effects "move" and "link".
 typedef CPError (STDCALL *CPB_SetDropEffectFunc)(
     CPID id, CPBrowsingContext context, struct NPObject* event, int effect);
 
+// For drag type "Files", the drag data returned by CPB_GetDragDataFunc() is a
+// backspace delimited list of file paths.  Use this routine to pass that data
+// to the browser process to verify that the renderer has permission to access
+// the files.  Returns CPERR_SUCCESS if access is allowed.
+typedef CPError (STDCALL *CPB_AllowFileDropFunc)(
+    CPID id, CPBrowsingContext context, const char* file_drag_data);
+
 // Function table for issuing requests using via the other side's network stack.
 // For the plugin, this functions deal with issuing requests through the
 // browser.  For the browser, these functions deal with allowing the plugin to
 // intercept requests.
 typedef struct _CPRequestFuncs {
   uint16 size;
   CPR_SetExtraRequestHeadersFunc set_extra_request_headers;
   CPR_SetRequestLoadFlagsFunc set_request_load_flags;
   CPR_AppendDataToUploadFunc append_data_to_upload;
   CPR_StartRequestFunc start_request;
@@ skipping 56 matching lines @@
   CPB_GetBrowsingContextFromNPPFunc get_browsing_context_from_npp;
   CPB_GetBrowsingContextInfoFunc get_browsing_context_info;
   CPB_GetCommandLineArgumentsFunc get_command_line_arguments;
   CPB_AddUICommandFunc add_ui_command;
   CPB_HandleCommandFunc handle_command;
   CPB_SendSyncMessageFunc send_sync_message;
   CPB_PluginThreadAsyncCallFunc plugin_thread_async_call;
   CPB_OpenFileDialogFunc open_file_dialog;
   CPB_GetDragDataFunc get_drag_data;
   CPB_SetDropEffectFunc set_drop_effect;
+  CPB_AllowFileDropFunc allow_file_drop;
 } CPBrowserFuncs;
 
 
 //
 // DLL exports
 //
 
 // This export is optional.
 // Prior to calling CP_Initialize, the browser may negotiate with the plugin
 // regarding which version of the CPAPI to utilize. 'min_version' is the
@@ skipping 15 matching lines @@
 // plugin should not attempt to call a browser function from a thread other
 // than the one CP_InitializeFunc is called from.
 typedef CPError (STDCALL *CP_InitializeFunc)(
     CPID id, const CPBrowserFuncs* bfuncs, CPPluginFuncs* pfuncs);
 
 #ifdef __cplusplus
 } // extern "C"
 #endif
 
 #endif // CHROME_COMMON_CHROME_PLUGIN_API_H__