SNAGetConfigValue

SNALink chiama la funzione SNAGetConfigValue per ottenere il valore di un parametro di configurazione specifico.

Sintassi

  
USHORT SNAGetConfigValue(  
UCHAR *entryName,  
VOID *pBuffer,  
ULONGbufferLen,  
UCHARparmType,  
ULONG *pRetLength  
);  

Parametri

Entryname
Nome del parametro di configurazione richiesto.

pBuffer
Puntatore a un buffer (se il parametro è una stringa) o un puntatore a un LONGINT (se il parametro è un intero).

bufferLen
Lunghezza del buffer. Obbligatorio solo se il parametro è TYPESTRING.

parmType
TYPESTRING se il parametro è una stringa.

TYPELONG se il parametro è un numero intero.

pRetLength
Numero di byte restituiti se il parametro è TYPESTRING o numero di byte disponibili se il buffer è troppo breve.

Valore restituito

NO_ERROR
OK.

ERBADCFG
Errore durante la lettura del file di configurazione.

ERNOTFND
Voce non trovata nel record di configurazione.

ERTOOLONG
I dati disponibili superano le dimensioni del buffer.

ERBADTYPE
È stato specificato un tipo non valido per il parametro parmType .

Commenti

È consigliabile che SNALink legge tutti i parametri di configurazione necessari al momento dell'inizializzazione (quando SNALinkInitialize viene chiamato dalla Base).