Share via


FPCVendorParametersSet object

Applies to: desktop apps only

The FPCVendorParametersSet object holds a private set of configuration data that a third party can associate with an extensible object. All Forefront TMG COM objects that have a VendorParametersSets property are extensible. This property retrieves an FPCVendorParametersSets collection that holds a group of FPCVendorParametersSet objects.

Each FPCVendorParametersSet object is identified by a globally unique identifier (GUID) that is provided to the Add method of its FPCVendorParametersSets collection when a new set is created.

The FPCVendorParametersSet object stores data that is defined as {name, value} pairs by using the Value property. The following example stores a parameter named x having a value of 1:

Dim vpSet As FPCVendorParametersSet
...
vpSet.Value("x") = 1

The expression "Value("x")" returns the value of the parameter x.

When FPCVendorParametersSet objects are used, a third party can take advantage of the configuration storage capabilities of Forefront TMG. The third-party data in an FPCVendorParametersSet object can be written to persistent storage by calling its Save method, the Save method of its FPCVendorParametersSets collection, the Save method of the object being extended, or the Save method of any object that contains the object being extended. Similarly, the stored values of the third-party data can be read from persistent storage by calling its Refresh method, the Refresh method of the FPCVendorParametersSets collection, the Refresh method of the object being extended, or the Refresh method of any object that contains the object being extended.

The FPCVendorParametersSet object is created as an element of an FPCVendorParametersSets collection.

Ff826839.bkbutton(en-us,VS.85).png Click here to see the Forefront TMG object hierarchy.

For examples of how vendor parameters sets are used to configure add-ins, see Configuring Add-ins.

Members

The FPCVendorParametersSet object has these types of members:

  • Methods
  • Properties

Methods

The FPCVendorParametersSet object has these methods.

Method Description
CancelWaitForChanges

Cancels the registration established by the WaitForChanges method (for use in C and C++ programming only).

Refresh

Reads the object's data from persistent storage, overwriting any changes that were not saved.

RemoveValue

Removes the specified value from the set.

Save

Writes the current values of all of the object's properties to persistent storage.

WaitForChanges

Registers to wait for an event indicating that the contents of the object have changed (for use in C and C++ programming only).

 

Properties

The FPCVendorParametersSet object has these properties.

Property Access type Description

AllNames

Read-only

Gets the names of all the parameters in the set.

Name

Read/write

Gets or sets the string-formatted globally unique identifier (GUID) of the parameters set.

Value

Read/write

Gets or sets the value associated with the parameter name supplied.

 

Interfaces for C++ Programming

This object implements the IFPCVendorParametersSet interface.

Requirements

Minimum supported client

Windows Vista, None supported

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

See also

COM Objects

 

 

Build date: 7/12/2010