SNAGetConfigValue

SNALink 會呼叫 SNAGetConfigValue 函式,以取得特定組態參數的值。

語法

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

參數

entryName
所需的組態參數名稱。

pBuffer
如果參數是字串) ,則為緩衝區的指標 (,如果參數是整數) ,則為 LONGINT (的指標。

bufferLen
緩衝區的長度。 只有在參數為 TYPESTRING 時才需要。

parmType
如果參數是字串,TYPESTRING。

如果參數是整數,則 TYPELONG。

pRetLength
如果參數是 TYPESTRING,則傳回的位元組數,或緩衝區太短時可用的位元組數目。

傳回值

NO_ERROR
正常。

ERBADCFG
讀取組態檔時發生錯誤。

ERNOTFND
組態記錄中找不到專案。

ERTOOLONG
可用的資料超過緩衝區的大小。

ERBADTYPE
已為 parmType 參數指定不正確的類型。

備註

強烈建議 SNALink 在初始化時讀取所有必要的組態參數, (當 Base) 呼叫 SNALinkInitialize 時。