QueueRequests Property of the IFPCCacheConfiguration Interface

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.

[C++]
HRESULT put_QueueRequests(
	VARIANT_BOOL fEnabled
);
HRESULT get_QueueRequests(
	VARIANT_BOOL* pfEnabled
);

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 Value

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

[Visual Basic]
Property QueueRequests As Boolean

Property Value

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

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

Client Requires Windows Vista or Windows XP.
Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
IDL

Declared in Msfpccom.idl.

DLL

Requires Msfpccom.dll.

See Also

FPCCacheConfiguration


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.