IFPCCacheConfiguration::QueueRequests property

Article
08/27/2012

Applies to: desktop apps only

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.

This property is read/write.

Syntax

HRESULT put_QueueRequests(
  VARIANT_BOOL fEnabled
);

HRESULT get_QueueRequests(
  VARIANT_BOOL *pfEnabled
);

' Data type: Boolean

Property QueueRequests( _
  ByVal fEnabled As VARIANT_BOOL, _
  ByVal pfEnabled As VARIANT_BOOL _
) As Boolean

Property value

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

Error codes

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 False (VARIANT_FALSE in C++).

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 a request comes in. This saves bandwidth and reduces server loads. However, for large objects, a 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 (VARIANT_TRUE in C++) only in environments where you are certain that only relatively small objects, such as SQL queries, will be requested.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll