GetAppcReturnCode

GetAppcReturnCode 関数は、動詞制御ブロック内のプライマリ リターン コードとセカンダリ リターン コードを印刷可能な文字列に変換します。 この関数は、5250 エミュレーターなどの APPC アプリケーションで使用する標準のエラー文字列のセットを提供します。

構文

  
    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で返されたエラー文字列の長さを示します。

戻り値 0 はエラーを示します。 Microsoft Windows では、 GetLastError の呼び出しによって、実際のエラー リターン コードが次のように提供されます。

0x20000001
パラメーターが無効です。関数は、指定された動詞制御ブロックから読み取ることができなかったか、指定されたバッファーに書き込めませんでした。

0x20000002
指定されたバッファーが小さすぎます。

0x20000003
APPC 文字列ライブラリ APPCST32.DLLを読み込めませんでした。

注釈

buffer_addrで返される説明エラー文字列は、改行文字 (\n) で終了しません。

説明的なエラー文字列はAPPCST32.DLLに含まれており、さまざまな言語に合わせてカスタマイズできます。

  • Last updated on