非推奨のStreamsアドバンスト・キューイング関数

表E-8は、この項で説明している非推奨のStreamsアドバンスト・キューイング関数を示しています。

表E-8 非推奨のStreamsアドバンスト・キューイング関数

関数	用途
OCIAQListen()	リストのエージェントの代理として1つ以上のキューをリスニングします。

OCIAQListen()

用途

リストのエージェントのかわりに1つ以上のキューをリスニングします。この関数は非推奨です。OCIAQListen2()を使用してください。

構文

sword OCIAQListen (OCISvcCtx      *svchp, 
                   OCIError       *errhp,
                   OCIAQAgent     **agent_list, 
                   ub4            num_agents,
                   sb4            wait, 
                   OCIAQAgent     **agent,
                   ub4            flags);

パラメータ

svchpp (IN/OUT)

サービス・コンテキスト・ハンドルです。

errhp (IN/OUT)

エラー発生時の診断情報のためにOCIErrorGet()に渡すエラー・ハンドルです。

agent_list (IN)

メッセージを監視するエージェントのリストです。

num_agents (IN)

エージェント・リスト内のエージェント数です。

wait (IN)

リスニング・コールのタイムアウト時間です。

agent (OUT)

メッセージの出力先のエージェントです。OCIAgentはOCI記述子です。

flags (IN)

現行では使用されていません。OCI_DEFAULTとして渡されます。

コメント

メッセージが存在し、リスト内のエージェントに対してそのメッセージを使用する準備ができたときに戻されるブロッキング・コールです。待機時間が終了してもメッセージが検出されない場合は、エラーが戻されます。

関連関数

OCIAQEnq()、OCIAQDeq()、OCIAQListen2()、OCISvcCtxToLda()、OCISubscriptionEnable()、OCISubscriptionPost()、OCISubscriptionRegister()、OCISubscriptionUnRegister()