GetAppcReturnCode

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

構文

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

パラメーター

vpb
指定されたパラメーター。 Verb 制御ブロックのアドレスを指定します。

buffer_length
指定されたパラメーター。 buffer_addr が指すバッファーの長さを指定します。 推奨される長さは 256 です。

buffer_addr
指定されたパラメーター。 書式設定された Null 終了文字列を保持するバッファーのアドレスを指定します。

戻り値

GetAppcReturnCode 関数は、成功した場合に正の値を返します。これは、buffer_addrで返されるエラー文字列の長さを示します。

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

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

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

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

注釈

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

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