Add Method of the IFPCNetworkTemplates Interface

  • Article

The Add method creates a new FPCNetworkTemplate object in the collection and returns a reference to it.

C++

Syntax

HRESULT Add(
  [in]   BSTR Name,
  [in]   BSTR XMLName,
  [in]   BSTR SmallBMPName,
  [in]   BSTR MediumBMPName,
  [in]   BSTR LargeBMPName,
  [out]  IFPCNetworkTemplate** ppNewNetworkTemplate
);

Parameters

  • Name
    BSTR that specifies the name of the new network template.

  • XMLName
    BSTR that specifies the name of the XML file for the new network template. The XML file specifies the network configuration and policies that will be defined in the new network template.

  • SmallBMPName
    BSTR that specifies the name of the small .bmp file for the new network template.

  • MediumBMPName
    BSTR that specifies the name of the medium .bmp file for the new network template.

  • LargeBMPName
    BSTR that specifies the name of the large .bmp file for the new network template.

  • ppNewNetworkTemplate
    Address of an interface pointer that on return points to the new IFPCNetworkTemplate interface added.

Return Value

This method can return one of the following:

  • S_OK, indicating that the operation succeeded.
  • An error code, indicating that the operation failed. In this case, the [out] parameter returned is a null object.

Visual Basic

Syntax

Function Add( _
  ByVal Name As String, _
  ByVal XMLName As String, _
  ByVal SmallBMPName As String, _
  ByVal MediumBMPName As String, _
  ByVal LargeBMPName As String _
) As FPCNetworkTemplate

Parameters

  • Name
    String that specifies the name of the new network template.
  • XMLName
    String that specifies the name of the XML file for the new network template. The XML file specifies the network configuration and policies that will be defined in the new network template.
  • SmallBMPName
    String that specifies the name of the small .bmp file for the new network template.
  • MediumBMPName
    String that specifies the name of the medium .bmp file for the new network template.
  • LargeBMPName
    String that specifies the name of the large .bmp file for the new network template.

Return Value

This method returns a reference to the FPCNetworkTemplate object added if the call is successful. Otherwise, an error is raised that can be intercepted by using an error handler.

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.
DLL

Requires Msfpccom.dll.

See Also

FPCNetworkTemplates

Send comments about this topic to Microsoft

Build date: 6/30/2010