FrcaCacheUnloadFile子例程

在线编辑

用途

从与 "快速响应高速缓存加速器" (FRCA) 实例关联的高速缓存中除去高速缓存条目。

库

FRCA 库 (libfrca.a)

语法

#include <frca.h>
int32_t FrcaCacheUnoadFile ( CacheHandle,  FrcaHandle,  FileSpec);
int32_t  CacheHandle;
int32_t  FrcaHandle;
frca_filespec_t * FileSpec;

描述

FrcaCacheUnoadFile子程序将从先前配置的 FRCA 实例的现有高速缓存实例中删除一个高速缓存条目。

参数

项 描述
CacheHandle 标识应从其中移除条目的高速缓存实例。
FrcaHandle 标识该高速缓存实例所属的 FRCA 实例。
FileSpec 指向 frca_loadfile_t 结构，该结构指定用于标识要从给定高速缓存中移除的高速缓存条目的特征。 该结构包含以下成员:
uint32_t  cacheEntryType;
char * fileName;
char * virtualHost;
char * searchKey;
注: 结构成员不一定显示在此顺序中。
cacheEntryType
指定该高速缓存条目的类型。 此字段必须设置为 FCTRL_CET_HTTPFILE。
fileName
指定将从高速缓存中移除的文件的绝对路径。
virtualHost
指定要由 FRCA 实例提供服务的虚拟主机名。
searchKey
指定可以在其下找到高速缓存条目的键。
注意：如果不存在具有相同类型、文件名、虚拟主机和搜索关键字的缓存条目，则FrcaCacheUnoadFile子例程成功。 如果与fileName关联的文件不存在，或者调用进程没有足够的访问权限，则此子程序失败。

返回值

项 描述
0 子例程已成功完成。
-1 子例程失败。 全局变量 错误号 已设置为指示特定类型的错误。

错误代码

项 描述
EINVAL FileSpec参数为零，或cacheEntryType组件未设置为FCTRL_CET_HTTPFILE，或searchKey组件为零，或fileName为"/"，或fileName不是绝对路径。
Efault FileSpec 参数或其中一个组件指向无效地址。
EACCES 对 fileName的访问许可权被拒绝。