IWMSDataContainerVersion Interface
.gif)
| Previous | Next |
IWMSDataContainerVersion Interface
The IWMSDataContainerVersion interface contains methods that enable you to specify and retrieve content information that can be used when checking whether a cached item is current. The following list provides an overview of this process:
- The client requests content that is stored in a file on both a cache server and the origin server.
- The cache server calls IWMSCacheProxy::QueryCache on the first enabled plug-in.
- The plug-in determines whether the content is cached. Assume a cache hit.
- The plug-in creates an IWMSDataContainerVersion object, retrieves information about the content on the cache server, and specifies the data members in the IWMSDataContainerVersion object.
- The plug-in checks the expiration date on the cached content. If it has not expired, the plug-in can call IWMSCacheProxyCallback::OnQueryCache and direct the server to stream the content. If it has expired, the plug-in calls IWMSCacheProxyServer::CompareContentInformation to determine whether the content is current.
- If the plug-in calls CompareContentInformation, the cache server calls the origin server to retrieve content information.
- The origin server calls IWMSDataSourcePlugin::GetDataContainerVersion on the appropriate data source plug-in, as determined by the data type associated with the physical URL of the requested content.
- The data source plug-in creates an IWMSDataContainerVersion object, retrieves information about the content on the origin server, and specifies the data members in the IWMSDataContainerVersion object. The origin server sends the information, including a pointer to the IWMSDataContainerVersion object, back to the cache server in a cache content information context.
- The cache server calls IWMSDataContainerVersion::Compare to compare the contents of the two IWMSDataContainerVersion objects.
- The cache server calls IWMSCacheProxyServerCallback::OnCompareContentInformation to indicate whether the content is current.
The IWMSDataContainerVersion interface is implemented by the server.
- Note This interface is available only on Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; and Windows Server 2008.
In addition to the methods inherited from IUnknown, the IWMSDataContainerVersion interface exposes the following methods.
| Method | Description |
| Compare | Compares two IWMSDataContainerVersion interfaces to determine whether they are equal. |
| GetCacheFlags | Retrieves flags that indicate whether content can be cached, proxied, or split. |
| GetContentSize | Retrieves the size of the content in bytes. |
| GetEntityTag | Retrieves an entity tag, given an index number. |
| GetEntityTagCount | Retrieves the number of entity tags. |
| GetExpirationTime | Retrieves the content expiration date. |
| GetLastModifiedTime | Retrieves the time at which the content was last modified. |
| SetCacheFlags | Specifies flags that indicate whether content can be cached, proxied, or split. |
| SetContentSize | Specifies the size of the content in bytes. |
| SetEntityTag | Specifies an entity tag. |
| SetExpirationTime | Specifies the content expiration date. |
| SetLastModifiedTime | Specifies the time at which the content was last modified. |
See Also
| Previous | Next |