Sous-programme FrcaCacheCreate

Editer en ligne

Objectif

Crée une instance de cache dans la portée d'une instance FRCA (Fast Response Cache Accelerator).

Bibliothèque

Bibliothèque FRCA (libfrca.a)

Syntaxe

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

Descriptif

Le sous-programme FrcaCacheCreate crée une instance de cache pour une instance FRCA déjà configurée. Plusieurs caches peuvent être créées pour une instance FRCA. Les descripteurs de cache sont uniques uniquement dans la portée de l'instance FRCA.

Paramètres

Article Descriptif
CacheHandle Renvoie un descripteur requis par les autres sous-routines liées au cache de l'API FRCA pour faire référence à l'instance de cache FRCA nouvellement créée.
FrcaHandle Identifie l'instance FRCA pour laquelle le cache est créé.
CacheSpec Pointe vers une structure Frca_ctrl_create_t , qui spécifie les caractéristiques du cache à créer. La structure contient les membres suivants:
uint32_t  cacheType;
uint32_t  nMaxEntries;
Les membres de la structure Remarque: n'apparaissent pas nécessairement dans cet ordre.
cacheType
Indique le type de l'instance de cache. Cette zone doit être définie sur FCTRL_SERVERTYPE_HTTP.
nMaxEntries
Indique le nombre maximal d'entrées autorisées pour l'instance de cache.

Valeurs renvoyées

Article Descriptif
0 La sous-routine a abouti.
-1 La sous-routine a échoué. La variable globale Errno est définie pour indiquer le type d'erreur spécifique.

Codes d'erreur

Article Descriptif
EINVAL Le paramètre CacheHandle ou CacheSpec est égal à zéro ou le paramètre CacheSpec n'est pas du type correct FCTRL_CACHETYPE_HTTP.
EFAULT CacheHandle ou CacheSpec pointe vers une adresse non valide.
ENOENT Le paramètre FrcaHandle n'est pas valide.