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 に含まれており、さまざまな言語に合わせてカスタマイズできます。