このドキュメントでは、次のトピックについて説明します。
NGUSVGDA
サーバーに、あるクライアントからメッセージ付きで提供されたデータを検索させます。 このサブプログラムは、DDE サーバーイベントのイベントハンドラで使用する必要があります。 DDE-VIEW.MESSAGE には、以下のいずれかの値が保持されます。 次に、イベントハンドラコードが DDE-VIEW.MESSAGE の値に作用することを確認する必要があります。
DDE-VIEW.MESSAGE の設定可能値は以下のとおりです。
| CONNECT | クライアントからの要求に応じて、トピック DDE-VIEW.TOPIC およびサービス DDE-VIEW.SERVICE との会話が確立されています。 トピックとサービスはサーバーによって登録されている必要があります。 DDE-VIEW.CONV-ID の値により、この会話は一意に識別されます。 |
|---|---|
| DISCONNECT | クライアントからの要求に応じて、DDE-VIEW.CONV-ID によって識別された会話は終了されています。 |
| REQUEST | DDE-VIEW.CONV-ID で指定された会話のクライアントにより、DDE-VIEW.ITEM で指定されたデータが要求されています。 |
| ADVISE | DDE-VIEW.CONV-ID で指定された会話のクライアントにより、DDE-VIEW.ITEM で指定されたデータのデータリンクが要求されています。 この場合、DDE サーバーのイベントハンドラは、会話中に新しいデータを使用できるようになったときは常に、NGU-SERVER-DATA サブプログラムを使用する必要があります。 |
| UNADVISE | DDE-VIEW.CONV-ID で指定された会話のクライアントにより、DDE-VIEW.ITEM で指定されたデータのデータリンクを閉じることが要求されています （このデータリンクは、以前は "Advise" を使用して開かれました。） |
| POKE | DDE-VIEW.CONV-ID で指定された会話のクライアントにより、DDE-VIEW.ITEM と DDE-VIEW.DATA で指定されたデータが送信されています。 これらのデータの長さは、DDE-VIEW.DATALEN です。 DDE-VIEW.DATA は、予期する会話に応じて適切に選択する必要があります。 |
| EXECUTE | DDE-VIEW.CONV-ID で指定された会話のクライアントにより、DDE-VIEW.DATA と DDE-VIEW.ITEM で指定されたコマンドの実行が要求されています。 このコマンドの長さは DDE-VIEW.DATALEN に保持されています。 |
| TIMEOUT | タイムアウトが発生しています。 指定された時間の間隔中にクライアントメッセージが受信されていません。 |
DDE-VIEW.MESSAGE の値が DISCONNECT、DATA、または NOTIFY の場合、DDE-VIEW.SERVICE フィールドおよび DDE-VIEW.TOPIC フィールドも適切に設定されます。
DDE-VIEW.TIMEOUT の値により、サーバーがメッセージを待機する最大時間（ミリ秒単位）を指定します。
"-1" に設定すると、サーバーは無期限に待機し続けます。
"0" に設定すると、保留されているものがある場合は直ちにメッセージが返されます。それ以外の場合は、"Timeout" が返されます。
その他の値に設定すると、メッセージが返される前に経過する正確な時間が DDE-VIEW.TIMEOUT 以上であることのみが保証されます。
| 名前／データタイプ | 説明 |
|---|---|
| 1 DDE-VIEW | DDE サブプログラムの PDA を入力／出力します。 |
| 2 SERVICE（A20） | サービス名。 |
| 2 TOPIC（A20） | トピック名。 |
| 2 CONV-ID（I4） | 会話 ID。 |
| 2 MESSAGE（A20） | メッセージ情報。 |
| 2 ITEM（A20） | 現在の会話の項目。 |
| 2 FORMAT（A20） | 送信されるデータのフォーマット。 |
| 2 TIMEOUT（I4） | サーバーメッセージがないために会話が中断されるまでの時間の間隔。 |
| 2 DATALEN（I2） | データの長さ。 |
| 2 DATA-ARRAY（A1/1:V） | |
| 1 Max-Index（I2） | DATA-ARRAY の Highest インデックスを入力します。任意の I2 値に設定できます。 |
| 1 Response（I4） | Natural エラーを出力します（該当する場合）。 |
