Subrotina FrcaCacheCreate

Propósito

Cria uma instância de cache dentro do escopo de uma instância do Fast Response Cache Accelerator (FRCA).

Biblioteca

Biblioteca FRCA (libfrca.a)

Sintaxe

#include <frca.h>
int32_t FrcaCacheCreate ( CacheHandle,  FrcaHandle,  CacheSpec);
int32_t *  CacheHandle;
int32_t    FrcaHandle;
frca_cache_create_t *  CacheSpec;

Descrição

A sub-rotina FrcaCacheCreate cria uma instância de cache para uma instância FRCA que já tenha sido configurada. Vários caches podem ser criados para uma instância FRCA. As alças de cache são exclusivas apenas dentro do escopo da instância FRCA.

Parâmetros

Item Descrição
CacheHandle Retorna uma alça que é necessária pelas demais subroutines relacionadas ao cache da API FRCA para referir-se à instância de cache FRCA recém-criada.
FrcaHandle Identifica a instância FRCA para a qual o cache é criado.
CacheSpec Aponta para uma estrutura frca_ctrl_create_t , que especifica as características do cache a ser criado. A estrutura contém os seguintes membros:
uint32_t  cacheType;
uint32_t  nMaxEntries;
Nota: Membros da estrutura não aparecem necessariamente nesta ordem.
cacheType
Especifica o tipo da instância de cache. Este campo deve ser configurado como FCTRL_SERVERTYPE_HTTP.
nMaxEntries
Especifica o número máximo de entradas permitidas para a instância de cache.

Valores De Retorno

Item Descrição
0 A subroutine completou com sucesso.
-1 A subroutine falhou. A variável global errno é configurada para indicar o tipo específico de erro.

Códigos De Erro

Item Descrição
EINVAL O parâmetro CacheHandle ou CacheSpec é zero ou o parâmetro CacheSpec não é do tipo correto FCTRL_CACHETYPE_HTTP.
EFAULT O CacheHandle ou CacheSpec apontam para um endereço inválido.
ENOENTE O parâmetro FrcaHandle é inválido