Microsoft Internet Security and Acceleration Server 2004 SDK

FwxListenerToCreatePercent Property of IFPCLowLevelSettings[C++]

FPCLowLevelSettings.FwxListenerToCreatePercent [Visual Basic]

[C++]

The FwxListenerToCreatePercent property gets or sets the percentage of the current number of sockets waiting for an incoming connection or for the first block of data on a Web listener that will be created when the percentage of sockets that are waiting for the first block of data out of the total number of waiting sockets on a Web listener reaches the maximum specified in the FwxListenerMaxPercent property.

HRESULT get_FwxListenerToCreatePercent(
  long* plPercentToCreate
);

HRESULT put_FwxListenerToCreatePercent(
  long lPercentToCreate
);

Parameters

plPercentToCreate
Pointer to a variable that on return receives a 32-bit integer specifying the percentage of the current number of sockets waiting for an incoming connection or for the first block of data on a Web listener that will be created when the percentage of sockets that are waiting for the first block of data out of the total number of waiting sockets on a Web listener reaches the maximum specified in the FwxListenerMaxPercent property.
lPercentToCreate
A 32-bit integer that specifies the percentage of the current number of sockets waiting for an incoming connection or for the first block of data on a Web listener that will be created when the percentage of sockets that are waiting for the first block of data out of the total number of waiting sockets on a Web listener reaches the maximum specified in the FwxListenerMaxPercent property.

Return Values

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Remarks

This property is read/write. Its default value is 240, and its range of permissible values is from 1 to 255. In common scenarios, there is no need to deviate from the default value. This value should be adjusted only for achieving improved performance.

For each Web listener, the Microsoft Firewall service initially creates 50 sockets that wait to accept a new incoming connection and to receive the first block of data. As each of these sockets completes its tasks of accepting a new incoming connection and receiving the first block of data, a new waiting socket is created for the Web listener.

Some of the waiting sockets can be in a state in which they have accepted an incoming connection, but have not received the first block of data. The Firewall service monitors the number of sockets in this state for each Web listener and maintains the percentage of waiting sockets that are in this state between the minimum percentage specified by the FwxListenerMinPercent property and the maximum percentage specified by the FwxListenerMaxPercent property. When the percentage drops to the minimum value, the Firewall service stops creating new waiting sockets for the Web listener until the number of waiting sockets decreases by the current number multiplied by the percentage specified in the FwxListenerToKillPercent property. When the percentage reaches the maximum value, the Firewall service creates new waiting sockets for the Web listener. The number of sockets created equals the current number of waiting sockets multiplied by the percentage specified in the FwxListenerToCreatePercent property.

If the total number of waiting sockets on all Web listeners defined in the array exceeds the number specified by the FwxListenerMaxPendingAccepts property, no new sockets are created.

[Visual Basic]

The FwxListenerToCreatePercent property gets or sets the percentage of the current number of sockets waiting for an incoming connection or for the first block of data on a Web listener that will be created when the percentage of sockets that are waiting for the first block of data out of the total number of waiting sockets on a Web listener reaches the maximum specified in the FwxListenerMaxPercent property.

Property FwxListenerToCreatePercent As Long

Property Value

A 32-bit integer that specifies the percentage of the current number of sockets waiting for an incoming connection or for the first block of data on a Web listener that will be created when the percentage of sockets that are waiting for the first block of data out of the total number of waiting sockets on a Web listener reaches the maximum specified in the FwxListenerMaxPercent property.

Remarks

This property is read/write. Its default value is 240, and its range of permissible values is from 1 to 255. In common scenarios, there is no need to deviate from the default value. This value should be adjusted only for achieving improved performance.

For each Web listener, the Microsoft Firewall service initially creates 50 sockets that wait to accept a new incoming connection and to receive the first block of data. As each of these sockets completes its tasks of accepting a new incoming connection and receiving the first block of data, a new waiting socket is created for the Web listener.

Some of the waiting sockets can be in a state in which they have accepted an incoming connection, but have not received the first block of data. The Firewall service monitors the number of sockets in this state for each Web listener and maintains the percentage of waiting sockets that are in this state between the minimum percentage specified by the FwxListenerMinPercent property and the maximum percentage specified by the FwxListenerMaxPercent property. When the percentage drops to the minimum value, the Firewall service stops creating new waiting sockets for the Web listener until the number of waiting sockets decreases by the current number multiplied by the percentage specified in the FwxListenerToKillPercent property. When the percentage reaches the maximum value, the Firewall service creates new waiting sockets for the Web listener. The number of sockets created equals the current number of waiting sockets multiplied by the percentage specified in the FwxListenerToCreatePercent property.

If the total number of waiting sockets on all Web listeners defined in the array exceeds the number specified by the FwxListenerMaxPendingAccepts property, no new sockets are created.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCLowLevelSettings