[C++]

The GetServiceRestartMask method retrieves a 32-bit bitmask of the FpcServices enumerated type that specifies which services need to be restarted for currently unsaved changes to take effect.

HRESULT GetServiceRestartMask(
  long* plServiceRestartMask
);

Parameters

plServiceRestartMask

[out] Pointer to a 32-bit integer that is set on return to a bitmask that specifies which services need to be restarted for currently unsaved changes to take effect.

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.

Remarks

The bitmask retrieved specifies the services that need to be restarted to apply any unsaved changes made to the object on which the method was called or any unsaved changes made to any of its subobjects.

The values defined in the FpcServices enumeration can be used to decrypt the bitmask and determine which services need to be restarted. Bit 0 corresponds to the Microsoft Firewall service, and bit 1 corresponds to the Microsoft ISA Server Job Scheduler service.

All unsaved changes can be applied with restarting of the required services by using either of the following techniques:

• Calling the Save method with both the fResetRequiredServices and fReloadConfiguration parameters set to VARIANT_TRUE on any object that contains the objects with configuration changes as subobjects.
• Calling Save with fResetRequiredServices set to VARIANT_FALSE and fReloadConfiguration set to VARIANT_TRUE on any object that contains the objects with configuration changes as subobjects and then calling the IFPCArray::RestartServices method with the applicable bitmask.

[Visual Basic]

The GetServiceRestartMask method retrieves a 32-bit bitmask of the FpcServices enumerated type that specifies which services need to be restarted for currently unsaved changes to take effect.

Function GetServiceRestartMask() As Long

Parameters

This method has no parameters.

Return Values

If successful, this method returns a 32-bit bitmask that specifies which services need to be restarted for currently unsaved changes to take effect. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

The bitmask retrieved specifies the services that need to be restarted to apply any unsaved changes made to the object on which the method was called or any unsaved changes made to any of its subobjects.

The values defined in the FpcServices enumeration can be used to decrypt the bitmask and determine which services need to be restarted. Bit 0 corresponds to the Microsoft Firewall service, and bit 1 corresponds to the Microsoft ISA Server Job Scheduler service.

• Calling the Save method with both the fResetRequiredServices and fReloadConfiguration parameters set to True on any object that contains the objects with configuration changes as subobjects.
• Calling Save with fResetRequiredServices set to False and fReloadConfiguration set to True on any object that contains the objects with configuration changes as subobjects and then calling the FPCArray.RestartServices method with the applicable bitmask.