IFPCArray::RestartServices[C++] | FPCArray.RestartServices [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

The RestartServices method restarts the services specified in a bitmask of the FpcServices enumerated type and any services that depend on them. This method can restart any service that can be specified by a value defined in the FpcServices enumerated type.


HRESULT RestartServices(
  FpcServices Services );

Parameters

Services
[in] Bitmask of the FpcServices enumerated type that specifies the services to be restarted.

Return Values

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Remarks

A bitmask specifying the services that need to be restarted to apply unsaved changes can be obtained by calling the GetServiceRestartMask method. Note that calling the Save method on any object clears all of the bits in the bitmask maintained internally by ISA Server.

This method does not return until all of the services that need to be restarted have finished restarting.

The Microsoft Firewall Service depends on the Microsoft Data Engine (MSDE) service. If this method is called to restart the MSDE service, it will also restart the Firewall service.

If a service specified is not running when this method is called, the method starts the service.

The RestartServices method restarts the services specified in a bitmask of the FpcServices enumerated type and any services that depend on them. This method can restart any service that can be specified by a value defined in the FpcServices enumerated type.


Sub RestartServices( _
  ByVal Services As FpcServices _
)

Parameters

Services
[in] Bitmask of the FpcServices enumerated type that specifies the services to be restarted.

Return Values

This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Remarks

A bitmask specifying the services that need to be restarted to apply unsaved changes can be obtained by calling the GetServiceRestartMask method. Note that calling the Save method on any object clears all of the bits in the bitmask maintained internally by ISA Server.

This method does not return until all of the services that need to be restarted have finished restarting.

The Microsoft Firewall Service depends on the Microsoft Data Engine (MSDE) service. If this method is called to restart the MSDE service, it will also restart the Firewall service.

If a service specified is not running when this method is called, the method starts the service.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCArray

Show: