IFPCNetwork::EnableWebProxyClients property

Article
08/27/2012

Applies to: desktop apps only

The EnableWebProxyClients property gets or sets a Boolean value that indicates whether Web proxy clients on the network are supported.

This property is read/write.

Syntax

HRESULT put_EnableWebProxyClients(
  VARIANT_BOOL fWebProxyClientsEnabled
);

HRESULT get_EnableWebProxyClients(
  VARIANT_BOOL *pfWebProxyClientsEnabled
);

' Data type: Boolean

Property EnableWebProxyClients( _
  ByVal fWebProxyClientsEnabled As VARIANT_BOOL, _
  ByVal pfWebProxyClientsEnabled As VARIANT_BOOL _
) As Boolean

Property value

Boolean value that indicates whether Web proxy clients on the network are supported.

Error codes

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Remarks

This property is read/write. Its default value is False (VARIANT_FALSE in C++).

For the Local Host network, this property must be set to True (VARIANT_TRUE in C++) before attempting to create a new content download job.

This property cannot be configured for the following predefined networks: Default External, Quarantined VPN Clients, and VPN Clients.

Examples

This VBScript code example enables listening for requests from Web proxy clients on the Local Host network if it is not enabled.

' Define an enumeration value.
const fpcLocalHost = 2
' Create the root object.
Set root = CreateObject("FPC.Root")
' Declare the other objects needed.
Dim isaArray  ' An FPCArray object
Dim networks  ' An FPCNetworks collection
Dim network   ' An FPCNetwork object
' Get references to the array object 
' and the networks collection.
Set isaArray = root.GetContainingArray()
Set networks = isaArray.NetworkConfiguration.Networks
' Iterate through the networks, and for the Local Host network,
' enable listening for requests from Web Proxy clients if it is
' not enabled.
For Each network In networks
    If network.NetworkType = fpcLocalHost Then
        If network.EnableWebProxyClients = False Then
            network.EnableWebProxyClients = True
            network.Save
        End If
    End If
Next

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll