FPCAdapter Object

The FPCAdapter object represents a single network adapter of a Forefront TMG computer. You can connect to the Internet through either a direct or dial-up connection. If you choose a direct connection, you need to set up an external network adapter.

This object represents that adapter and can be an element of an FPCAdapters collection or an FPCAllAdapters collection.

Click here to see the Forefront TMG object hierarchy.

Methods

The FPCAdapter object defines the following methods.

Method	Description
EnableAutoDnsDetection	Enables the automatic detection of DNS servers.
EnableDhcp	Enables the network adapter to obtain an IP address from a DHCP server.
GetDeviceGuid	Gets the string-formatted globally unique identifier (GUID) of the network adapter.
GetPrimaryDnsServer	Gets the IP address of the primary DNS server of the network adapter.
GetPrimaryGateway	Gets the primary gateway of the network adapter.
GetPrimaryIpAddress	Gets the primary IP address of the network adapter.
GetPrimarySubnetMask	Gets the primary subnet mask of the network adapter.
GetSecondaryDnsServer	Gets the IP address of the secondary DNS server of the network adapter.
IsIpInAddressSet	Determines whether an IP address is included in the address set of the adapter.
SetPrimaryDnsServer	Sets the IP address of the primary DNS server of the network adapter.
SetPrimaryGateway	Sets the primary gateway of the network adapter.
SetPrimaryIpAddress	Sets the primary IP address of the network adapter.
SetPrimarySubnetMask	Sets the primary subnet mask of the network adapter.
SetSecondaryDnsServer	Sets the IP address of the secondary DNS server of the network adapter.

Properties

The FPCAdapter object defines the following properties.

Property	Description
Addresses	Gets or sets a comma-delimited list of all IP addresses bound to the network adapter.
AutoDnsServerDetection	Gets a Boolean value that indicates whether DNS servers will be detected automatically.
ConnectionSpecificDnsSuffix	Gets the connection-specific DNS suffix of the network adapter.
ConnectionType	Gets or sets or sets a value from the FpcAdapterConnectionType enumerated type that specifies the type of connection to the network adapter.
Description	Gets the description of the network adapter.
DhcpEnabled	Gets a Boolean value that indicates whether the network adapter uses the Dynamic Host Configuration Protocol (DHCP).
DhcpServer	Gets the IP address of the DHCP server for the network adapter.
DnsServers	Gets a comma-delimited list of all DNS servers defined for the network adapter.
Enabled	Gets a Boolean value that indicates whether the adapter is enabled.
FriendlyName	Gets the friendly name of the network adapter.
Gateways	Gets or sets a comma-delimited list of all the gateways configured on the network adapter.
IpAddresses	Gets a comma-delimited list of all IP addresses bound to the network adapter. (This property is deprecated in Forefront TMG.)
IpAddressSet	Gets the IP address set for the network adapter.
IpRanges	Gets an FPCReadOnlyIpRangeSet collection that contains objects representing the IP ranges for the adapter.
PhysicalAddress	Gets the physical address of the network adapter.
PrimaryWinsServer	Gets the IP address of the primary WINS server of the network adapter.
SecondaryWinsServer	Gets the IP address of the secondary WINS server of the network adapter.
State	Gets a value from the FpcAdapterState enumerated type that specifies the state of the network adapter.
SubnetMasks	Gets or sets a comma-delimited list of all subnet masks configured on the network adapter.

Interfaces for C++ Programming

This object implements the IFPCAdapter, IFPCAdapter2, and IFPCAdapter3 interfaces.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.

See Also

COM Objects

Send comments about this topic to Microsoft

Build date: 6/30/2010