GetAppcReturnCode

GetAppcReturnCode函式會將動詞控制項區塊中的主要和次要傳回碼轉換為可列印的字串。 此函式提供一組標準錯誤字串，以供 APPC 應用程式使用，例如 5250 模擬器。

語法

  
    int WINAPI GetAppcReturnCode(   
struct appc_hdr FAR * vpb,  
UINTbuffer_length,  
unsigned char FAR * buffer_addr);  

參數

vpb
提供的參數。 指定動詞控制項區塊的位址。

buffer_length
提供的參數。 指定 buffer_addr所指向的緩衝區長度。 建議的長度為 256。

buffer_addr
提供的參數。 指定將保存格式化、Null 終止字串的緩衝區位址。

傳回值

GetAppcReturnCode函式會在成功時傳回正值，指出傳回buffer_addr的錯誤字串長度。

傳回值為零表示錯誤。 在 Microsoft Windows 上， 呼叫 GetLastError 會提供實際的錯誤傳回碼，如下所示：

0x20000001
參數無效;函式無法從指定的動詞控制區塊讀取，或無法寫入指定的緩衝區。

0x20000002
指定的緩衝區太小。

0x20000003
無法載入 APPC 字串程式庫 APPCST32.DLL。

備註

buffer_addr中傳回的描述性錯誤字串不會以新行字元終止， (\n) 。

描述性錯誤字串包含在 APPCST32.DLL 中，並可針對不同的語言自訂。