IFPCAdapter2::Gateways property

Applies to: desktop apps only

The Gateways property gets or sets a comma-delimited list of all the gateways configured on the network adapter.

This property is read/write.

Syntax

HRESULT put_Gateways(
  BSTR bstrGateways
);

HRESULT get_Gateways(
  BSTR *pbstrGateways
);
' Data type: String

Property Gateways( _
  ByVal bstrGateways As BSTR, _
  ByVal pbstrGateways As BSTR _
) As String

Property value

String that specifies a comma-delimited list of all the gateways configured on the network adapter.

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 value is initially set based on the configuration settings of the network adapter in Windows Server.

Examples

You can set the Gateways property to an empty string to unset the default gateway on a network adapter.

This C++ code fragment unsets the default gateway on a network adapter using the put_Gateways property method.

CComBSTR sbstrEmpty(L"");
ASSERT(!!sbstrEmpty);
//...
HRESULT hr = ipAdapter->put_Gateways(sbstrEmpty);
//...

This Visual Basic code fragment unsets the default gateway on a network adapter using the Gateways property.

ipAdapter.Gateways = ""

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

See also

FPCAdapter

 

 

Build date: 7/12/2010