1eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/* Copyright 2013 The Chromium Authors. All rights reserved. 2eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * Use of this source code is governed by a BSD-style license that can be 3eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * found in the LICENSE file. 4eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 5eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 6eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/* From ppb_network_proxy.idl modified Fri Jun 21 09:37:20 2013. */ 7eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 8eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#ifndef PPAPI_C_PPB_NETWORK_PROXY_H_ 9eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#define PPAPI_C_PPB_NETWORK_PROXY_H_ 10eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 11eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_bool.h" 12eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_completion_callback.h" 13eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_instance.h" 14eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_macros.h" 15eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_stdint.h" 16eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#include "ppapi/c/pp_var.h" 17eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 18eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#define PPB_NETWORKPROXY_INTERFACE_1_0 "PPB_NetworkProxy;1.0" 19eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#define PPB_NETWORKPROXY_INTERFACE PPB_NETWORKPROXY_INTERFACE_1_0 20eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 21eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/** 22eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @file 23eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * This file defines the <code>PPB_NetworkProxy</code> interface. 24eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 25eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 26eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 27eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/** 28eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @addtogroup Interfaces 29eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @{ 30eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 31eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/** 32eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * This interface provides a way to determine the appropriate proxy settings 33eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * for a given URL. 34eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 35eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * Permissions: Apps permission <code>socket</code> with subrule 36eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * <code>resolve-proxy</code> is required for using this API. 37eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * For more details about network communication permissions, please see: 38eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * http://developer.chrome.com/apps/app_network.html 39eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 40eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochstruct PPB_NetworkProxy_1_0 { 41eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch /** 42eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * Retrieves the proxy that will be used for the given URL. The result will 43eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * be a string in PAC format. For more details about PAC format, please see 44eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * http://en.wikipedia.org/wiki/Proxy_auto-config 45eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 46eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @param[in] instance A <code>PP_Instance</code> identifying one instance 47eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * of a module. 48eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 49eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @param[in] url A string <code>PP_Var</code> containing a URL. 50eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 51eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @param[out] proxy_string A <code>PP_Var</code> that GetProxyForURL will 52eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * set upon successful completion. If the call fails, <code>proxy_string 53eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * </code> will be unchanged. Otherwise, it will be set to a string <code> 54eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * PP_Var</code> containing the appropriate PAC string for <code>url</code>. 55eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * If set, <code>proxy_string</code> will have a reference count of 1 which 56eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * the plugin must manage. 57eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 58eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon 59eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * completion. 60eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * 61eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @return An int32_t containing an error code from <code>pp_errors.h</code>. 62eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 63eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch int32_t (*GetProxyForURL)(PP_Instance instance, 64eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch struct PP_Var url, 65eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch struct PP_Var* proxy_string, 66eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch struct PP_CompletionCallback callback); 67eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch}; 68eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 69eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdochtypedef struct PPB_NetworkProxy_1_0 PPB_NetworkProxy; 70eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch/** 71eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch * @} 72eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch */ 73eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 74eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch#endif /* PPAPI_C_PPB_NETWORK_PROXY_H_ */ 75eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch 76