Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The SetProxySettings method modifies the proxy settings for the BITS transfer job
Syntax
uint32 SetProxySettings(
[in] uint16 ProxyUsage,
[in, optional] string ProxyList,
[in, optional] string ProxyBypassList
);
Parameters
-
ProxyUsage [in]
-
Specifies whether the user's proxy settings will be used, whether a proxy will be used, or whether application-specific proxy settings will be used. The default is to use the user's proxy settings. This parameter can be set to one of the following values:
Value Meaning - 0
Use the Internet Explorer proxy and the proxy bypass list settings that are defined by each user to transfer files. Settings are defined by the user in the local area network (LAN) settings (or dial-up settings, depending on the network connection) in the Network and Internet item in Control Panel. - 1
Do not use a proxy to transfer files. Use this value when you transfer files within a LAN. - 2
Use the application's proxy and the proxy bypass list to transfer files. Use this value if you are not sure that the system settings are correct. Also, use this value when you want to transfer files by using a special account, such as LocalSystem, for which the system settings do not apply. - 3
Automatically detect the proxy settings. BITS detects the proxy settings for each file in the BITS transfer job. -
ProxyList [in, optional]
-
Specifies a null-terminated string that contains the proxies to use to transfer files. The list is space-delimited. This parameter must be NULL if the value of ProxyUsage is set to 0, 1, or 3.
-
ProxyBypassList [in, optional]
-
Specifies a null-terminated string that contains an optional list of host names, IP addresses, or both, that can bypass the proxy. The list is space-delimited. This parameter must be NULL if the value of ProxyUsage is set to 0, 1, or 3.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 R2 |
| Redistributable |
Windows Management Framework on Windows Server 2008 with SP2 |
| Namespace |
Root\microsoft\bits |
| MOF |
|