[C++]

The CreateConfigurationGroupInstance method creates an instance of the IFPCSystemPolicyConfigGroup interface for the system policy configuration group requested and supplies a pointer to it.

HRESULT CreateConfigurationGroupInstance(
  FpcSystemPolicyConfigGroupEnum Service,
  IFPCSystemPolicyConfigGroup** ppConfigGroup
);

Parameters

Service

[in] Value from the FpcSystemPolicyConfigGroupEnum enumerated type that indicates a specific configuration group.

ppConfigGroup

[out] Address of an interface pointer that on return points to the instance of the IFPCSystemPolicyConfigGroup interface created.

Return Values

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.

Remarks

Each new instance of the IFPCSystemPolicyConfigGroup interface is created with the last saved properties of the rules belonging to the applicable configuration group.

Changes made in a configuration group can be saved only by calling the Save method on the IFPCSystemPolicyConfigGroup interface. They are not written to persistent storage when the FPCSystemPolicy object or any object above it in the ISA Server object hierarchy is saved.

[Visual Basic]

The CreateConfigurationGroupInstance method creates an instance of the FPCSystemPolicyConfigGroup object for the system policy configuration group requested and returns a reference to it.

Function CreateConfigurationGroupInstance( _
  ByVal Service As FpcSystemPolicyConfigGroupEnum _
) As FPCSystemPolicyConfigGroup

Parameters

Service

[in] Value from the FpcSystemPolicyConfigGroupEnum enumerated type that indicates a specific configuration group.

Return Values

This method returns a reference to the instance of the FPCSystemPolicyConfigGroup object created if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

Each new instance of the FPCSystemPolicyConfigGroup object is created with the last saved properties of the rules belonging to the applicable configuration group.

Changes made in a configuration group can be saved only by calling the Save method on the FPCSystemPolicyConfigGroup object. They are not written to persistent storage when the FPCSystemPolicy object or any object above it in the ISA Server object hierarchy is saved.