[C++]

The GetContainingServer method retrieves the IFPCServer interface that represents the current ISA Server computer.

HRESULT GetContainingServer(
  IFPCServer** ppItem
);

Parameters

ppItem

[out] Address of an interface pointer that on return points to the IFPCServer interface that represents the current ISA Server computer.

Return Values

This method can return one of the following:

• S_OK, indicating that the operation succeeded.
• ERROR_FILE_NOT_FOUND, indicating that the IFPCServer interface could not be found because the method was called on a remote administration computer on which the Microsoft Firewall service is not running. In this case, the [out] parameter returned is a null object.
• An error code indicating that the operation failed. In this case, the [out] parameter returned is a null object.

[Visual Basic]

The GetContainingServer method retrieves the FPCServer object that represents the current ISA Server computer.

Function GetContainingServer() As FPCServer

Parameters

This method has no parameters.

Return Values

This method returns a reference to an FPCServer object if successful. Otherwise, an error is raised that can be intercepted by using an error handler. In particular, an ERROR_FILE_NOT_FOUND is raised if the FPCServer object could not be found because the method was called on a remote administration computer on which the Microsoft Firewall service is not running.

Example Code

The following Visual Basic code example retrieves the name of the current ISA Server computer by means of the GetContainingServer method.

Dim root As New FPCLib.FPC
Dim containingServer As String
containingServer = root.GetContainingServer.Name