データの受信

次の呼び出しまたは拡張機能を使用すると、プログラムはパートナー プログラムからデータを受信できます。

Note

呼び出しの名前は仮名です。 実際の C 関数名は、仮名の後にかっこで囲んで表示されます。 たとえば、 Accept_Conversation は呼び出しの仮名です。 実際の関数名は cmaccp です。

Receive( cmrcv)
会話が RECEIVE 状態の間にこの呼び出しを発行すると、ローカル・プログラムは、パートナー・プログラムから現在使用可能なすべてのデータを受け取ります。 使用可能なデータがなく、受信の種類が CM_RECEIVE _AND_WAIT に設定されている場合、ローカル プログラムはデータの到着を待機します。 受信の種類が CM_RECEIVE_IMMEDIATE に設定されている場合、プログラムは待機しません。

メッセージ交換が SEND または SEND_PENDING 状態の間にこの呼び出しを発行することは、受信の種類が CM_RECEIVE_AND_WAIT に設定されている場合にのみ許可されます。 これにより、論理ユニットの (LU) 送信バッファーがフラッシュされ、会話の状態が RECEIVE に変更されます。 その後、ローカル プログラムはデータの受信を開始します。

Set_Fill( cmsf)
基本的な会話で使用されるこの呼び出しは、メッセージ交換の塗りつぶしの種類を設定します。これにより、プログラムが論理レコードの形式でデータを受信するか、指定した長さのデータとしてデータを受信するかを指定します。 この呼び出しは、基本的な会話でのみ有効です。 fill 値は、後続のすべての Receive 呼び 出 しに影響します。 Set_Fillを再発行することで変更できます。

Set_Processing_Mode( cmspm)
要求した操作が完了したときに後続の呼び出しを返す (ブロックする) か、操作が開始された直後 (非ブロッキング) かを会話に指定します。 プログラムは、Wait_For_Conversationを発行するとき、または Specify_Windows_Handle の hwndNotify パラメーターによって識別された WndProc に送信された Microsoft Windows メッセージを介して、非ブロッキング呼び出しが完了したことを通知します。

Set_Receive_Type( cmsrt)
メッセージ交換の受信の種類を設定します。これは、 受信 呼び出しを発行するプログラムが、データが使用できない場合にデータの到着を待機するかどうかを指定します。 受信の種類の値は、後続のすべての 受信 呼び出しに影響します。 Set_Receive_Typeを再発行することで変更できます。

Specify_Windows_Handle( xchwnd)
非ブロッキング モードでの操作の完了時にメッセージが送信されるウィンドウ ハンドルを設定します。 アプリケーションは、Set_Processing_Modeを呼び出すことによって処理モード を設定できます。 ウィンドウ ハンドルが NULL に設定されているか、この呼び出しが発行されない場合、未処理の操作が完了したときに通知を受け取るために、アプリケーションは Wait_For_Conversation を呼び出す必要があります。