Unterprogramm FrcaCacheCreate

Online bearbeiten

Zweck

Erstellt eine Cacheinstanz im Geltungsbereich einer FRCA-Instanz (Fast Response Cache Accelerator).

Bibliothek

FRCA-Bibliothek (libfrca.a)

Syntax

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

Beschreibung

Die Unterroutine FrcaCacheCreate erzeugt eine Cache-Instanz für eine bereits konfigurierte FRCA-Instanz. Für eine FRCA-Instanz können mehrere Caches erstellt werden. Cache-Handles sind nur im Geltungsbereich der FRCA-Instanz eindeutig.

Parameter

Element Beschreibung
CacheHandle Gibt eine Kennung zurück, die von den anderen cachebezogenen Subroutinen der FRCA-API benötigt wird, um auf die neu erstellte FRCA-Cacheinstanz zu verweisen.
FrcaHandle Gibt die FRCA-Instanz an, für die der Cache erstellt wird
CacheSpec Verweist auf eine frca_ctrl_create_t -Struktur, die die Merkmale des zu erstellenden Cache angibt. Die Struktur enthält die folgenden Member:
uint32_t  cacheType;
uint32_t  nMaxEntries;
Anmerkung: Strukturmember werden nicht unbedingt in dieser Reihenfolge angezeigt.
cacheType
Gibt den Typ der Cacheinstanz an Dieses Feld muss auf FCTRL_SERVERTYPE_HTTP gesetzt werden.
nMaxEntries
Gibt die maximale Anzahl zulässiger Einträge für die Cacheinstanz an.

Rückgabewerte

Element Beschreibung
0 Die Subroutine wurde erfolgreich beendet.
-1 Die Subroutine ist fehlgeschlagen. Die globale Variable Fehlernummer wird festgelegt, um den spezifischen Fehlertyp anzugeben.

Fehlercodes

Element Beschreibung
EINVAL Der Parameter CacheHandle oder der Parameter CacheSpec ist null oder der Parameter CacheSpec hat nicht den richtigen Typ FCTRL_CACHETYPE_HTTP.
EFAULT Die CacheHandle oder die CacheSpec verweisen auf eine ungültige Adresse.
ENOENT Der Parameter FrcaHandle ist ungültig.