Microsoft Internet Security and Acceleration Server 2004 SDK

QueueRequests Property of IFPCCacheConfiguration[C++]

FPCCacheConfiguration.QueueRequests [Visual Basic]

[C++]

The QueueRequests property gets or sets a Boolean value that indicates whether requests for objects are queued if those objects are in the process of being stored in the cache.

HRESULT get_QueueRequests(
  VARIANT_BOOL* pfEnabled
);

HRESULT put_QueueRequests(
  VARIANT_BOOL fEnabled
);

Parameters

pfEnabled
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if the queuing of requests is enabled, or to VARIANT_FALSE if the queuing of requests is disabled.
fEnabled
Boolean value that specifies whether the queuing of requests is enabled.

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.

Note  This feature should be used carefully. It allows you to queue requests for objects if those objects are being downloaded to the cache when the request comes in. This saves bandwidth and reduces server loads. However, for large objects, the queued request may experience a long delay while the object is cached. In that case, if the request had not been queued, initial chunks of the large object would have been retrieved while the request continued to download data directly from the Internet. This property should therefore be set to VARIANT_TRUE only in environments where you are certain that only relatively small objects, such as SQL queries, will be requested.

[Visual Basic]

The QueueRequests property gets or sets a Boolean value that indicates whether requests for objects are queued if those objects are in the process of being stored in the cache.

Property QueueRequests As Boolean

Property Value

Boolean value that specifies whether the queuing of requests is enabled.

Remarks

This property is read/write.

Note  This feature should be used carefully. It allows you to queue requests for objects if those objects are being downloaded to the cache when the request comes in. This saves bandwidth and reduces server loads. However, for large objects, the queued request may experience a long delay while the object is cached. In that case, if the request had not been queued, initial chunks of the large object would have been retrieved while the request continued to download data directly from the Internet. This property should therefore be set to True only in environments where you are certain that only relatively small objects, such as SQL queries, will be requested.

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

FPCCacheConfiguration