IWMSCacheProxy.QuerySpaceForCacheItem (C#)

IWMSCacheProxy.QuerySpaceForCacheItem (C#)

The QuerySpaceForCacheItem method is called by the server to retrieve a Boolean value indicating whether the cache has adequate storage for a specific content item.

Syntax

Parameters

lContentSizeLow

[in] int containing the low-order 8 bytes of a 64-bit integer.

lContentSizeHigh

[in] int containing the high-order 8 bytes of a 64-bit integer.

pvarfSpaceAvail

[out] Reference to a boolean that indicates whether the cache has enough available storage.

Return Values

This method does not return a value. To report an error, the plug-in can throw a COMException object to the server. If the plug-in uses the IWMSEventLog object to log error information, it is recommended that it throw NS_E_PLUGIN_ERROR_REPORTED (0xC00D157D). Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog object to send custom error information to the Windows Event Viewer, throwing NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about plug-in error information, see Identifying Plug-in Errors.

Remarks

lContentSizeHigh and lContentSizeLow are 32-bit signed long integers that represent the upper and lower 8 bytes of a 64-bit integer.

Example Code

using Microsoft.WindowsMediaServices.Interop;
using System.Runtime.InteropServices;

void IWMSCacheProxy.QuerySpaceForCacheItem(int lContentSizeLow,
                                           int lContentSizeHigh,
                                           out System.Boolean bSpaceAvail)
{
  try
  {
    // TODO: Call a user-defined function to determine
    // whether adequate storage exists.
    bSpaceAvail = QuerySpace(lContentSizeLow, lContentSizeHigh); 
  }
  catch
  {
    throw new COMException();
  }

  return;
}

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

• IWMSCacheProxy Object (C#)