GetContainingServer Method of the IFPC Interface

Syntax

HRESULT GetContainingServer(
  [out]  IFPCServer** ppItem
);

Parameters

ppItem

Address of an interface pointer that on return points to the IFPCServer interface that represents the current Forefront TMG computer.

Return Value

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 management computer or a Configuration Storage server on which the Microsoft Firewall service is not installed. 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.

Syntax

Function GetContainingServer() As FPCServer

Parameters

Return Value

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 management computer or a Configuration Storage server on which the Microsoft Firewall service is not installed.

Example Code

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