3.2.4.4 GetFirewallProductsInformation Abstract Interface

This abstract interface is called to initialize the FirewallProductsInformation ADM element described in section 3.2.1.

 DWORD GetFirewallProductsInformation(
     [out] ProductInformation **ppFirewallProductsInformation);

ppFirewallProductsInformation: A pointer to a variable that receives the address of the array of ProductInformation structures as described in section 2.2.15.1.

Return Values

Value

Description

S_OK (0x00000000)

The product information was successfully set in the ppFirewallProductsInformation array parameter.

E_OUTOFMEMORY (0x80000002)

The interface failed to retrieve the information about the firewall products. No values were set in the ppFirewallProductsInformation parameter.

Remarks

The interface allocates the memory required to accommodate the array of ProductInformation structures. This memory should be freed by calling to the FreeProductsInformation abstract interface described in section 3.2.4.11.