戻りパラメーター

この関数はデータ・ストリングおよび戻りコードを戻します。

データ・ストリング:: A (非同期) をバイト位置 5 (標準インターフェースの場合は 2) に指定して、関数が正常終了した場合、以下のデータ・ストリングが戻されます。

バイト		定義
9–10	13–14	2 バイトの関数要求 ID。この関数要求 ID は、この関数呼び出しの完了を判別するために Get Request Completion (125) 関数で使用します。
	15 ～ 16	予約済み。
	17–20	EHLLAPI によってイベント・オブジェクト・アドレスが戻される 4 バイト値。アプリケーションは、このイベント・オブジェクトを待ちます。イベント・オブジェクトがクリアされる場合、アプリケーションは Get Request Completion (125) 関数呼び出しを発行して、Write Structured Fields 要求の結果を取得しなければなりません (32 ビットの場合のみ)。

注: イベント・オブジェクトは、非同期要求が正常終了するたびに戻されます。イベント・オブジェクトは再使用しないでください。要求ごとに新しいイベント・オブジェクトが戻され、そのイベント・オブジェクトはその要求の間だけ有効です。

データ・ストリング:: M (非同期メッセージ・モード) をバイト位置 5 (標準インターフェースの場合は 2) に指定して、関数が正常終了した場合、以下のデータ・ストリングが戻されます。

バイト		定義
9–10	13–14	2 バイトの関数要求 ID。この関数要求 ID は、この関数呼び出しの完了を判別するために Get Request Completion (125) 関数で使用します。
9–10	15 ～ 16	予約済み。
11–12	17 ～ 18	非同期メッセージ・モードのタスク ID。
11–12	19 ～ 20	予約済み。

注: 関数が正常終了した場合、アプリケーション・ウィンドウはメッセージを受け取ります。メッセージは、RegisterWindowMessage(PCSHLL) の戻り値です。wParam パラメーターには、関数呼び出しによって戻されたタスク ID が入ります。lParam パラメーターの HIWORD には戻りコード 0 (関数の正常終了) が、LOWORD には関数番号 127 が入ります。

戻りコード:: 以下のコードが定義されています。

戻りコード	説明
0	Write Structured Fields 関数は正常終了しました。
1	無効なホスト表示スペースの短縮セッション ID が指定されたか、またはホスト表示スペースが接続されていません。
2	パラメーター指定でエラーが発生しました。
9	システム・エラーが発生しました。
11	リソースが使用できません。(メモリーが使用できません。)
34	インバウンドでホストに送信されたメッセージが取り消されました。
35	ホストからのアウトバウンド送信が取り消されました。
36	要求はリジェクトされました。ホストと接続できません。
37	失敗しました。ホストのインバウンド送信は使用できません。