3.5.4.4.1 GetIcfEnabled Method (Opnum 3)

The GetIcfEnabled method<352> retrieves the status of whether the "Basic Firewall" or "Internet Connection Firewall" feature is enabled on RRAS server.

 HRESULT GetIcfEnabled([out] BOOL * status);

Status: This is a pointer to a BOOL. The value of the method is either TRUE or FALSE. If TRUE, indicates that basic firewall is enabled on the server. If FALSE, indicates that basic firewall is disabled on the server.

Return Values: The server MUST return zero if it successfully processes the message. If processing fails, the server MUST return a nonzero HRESULT error code, as defined in [MS-DTYP] section 2.2.18, between 0x80000000 and 0xFFFFFFFF, as specified in [MS-ERREF] section 2.1. All nonzero values MUST be treated as equivalent failures.

When processing this call, the RRASM server MUST do the following:

  • Call the abstract interface Invoke REMRAS method specifying the operation and the parameters to enable RRAS server to perform the required management task.

  • Return any error status the RRAS server returns. Otherwise return ERROR_SUCCESS.

    No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].