アプリケーションは、メッセージ・プロデューサーを使用して、メッセージを宛先に送信します。
xms::PropertyContext | +----xms::MessageProducer
MessageProducer オブジェクトの XMS 定義プロパティーのリストについては、MessageProducer のプロパティーを参照してください。
メソッド | 説明 |
---|---|
close | メッセージ・プロデューサーを閉じます。 |
getDeliveryMode | メッセージ・プロデューサーによって送信されるメッセージのデフォルト送達モードを取得します。 |
getDestination | メッセージ・プロデューサーの宛先を取得します。 |
getDisableMsgID | 受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにメッセージ ID が含まれていることを要求するかどうかの標識を取得します。 |
getDisableMsgTS | 受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにタイム・スタンプが含まれていることを要求するかどうかの標識を取得します。 |
getHandle | C アプリケーションがメッセージ・プロデューサーにアクセスするときに使用するハンドルを取得します。 |
getPriority | メッセージ・プロデューサーによって送信されるメッセージのデフォルト優先順位を取得します。 |
getTimeToLive | 有効期限が切れるまでの、メッセージが存続するデフォルトの時間長を取得します。 |
isNull | MessageProducer オブジェクトがヌル・オブジェクトであるかどうかを判別します。 |
send | メッセージ・プロデューサーが作成されたときに指定された宛先に、メッセージを送信します。メッセージ・プロデューサーのデフォルト送達モード、優先順位、および存続時間を使用してメッセージを送信します。 |
send | メッセージ・プロデューサーが作成されたときに指定された宛先に、メッセージを送信します。指定された送達モード、優先順位、および存続時間を使用してメッセージを送信します。 |
send | メッセージ・プロデューサーの作成時に宛先が指定されなかったメッセージ・プロデューサーを使用する場合に、指定した宛先にメッセージを送信します。メッセージ・プロデューサーのデフォルト送達モード、優先順位、および存続時間を使用してメッセージを送信します。 |
send | メッセージ・プロデューサーの作成時に宛先が指定されなかったメッセージ・プロデューサーを使用する場合に、指定した宛先にメッセージを送信します。指定された送達モード、優先順位、および存続時間を使用してメッセージを送信します。 |
setDeliveryMode | メッセージ・プロデューサーによって送信されるメッセージのデフォルト送達モードを設定します。 |
setDisableMsgID | 受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにメッセージ ID が含まれることを要求するかどうかを示します。 |
setDisableMsgTS | 受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにタイム・スタンプが含まれることを要求するかどうかを示します。 |
setPriority | メッセージ・プロデューサーによって送信されるメッセージのデフォルト優先順位を設定します。 |
setTimeToLive | 有効期限が切れるまでの、メッセージが存続するデフォルトの時間長を設定します。 |
xmsBOOL getDisableMsgID() const;
受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにメッセージ ID が含まれていることを要求するかどうかの標識を取得します。
xmsBOOL getDisableMsgTS() const;
受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにタイム・スタンプが含まれていることを要求するかどうかの標識を取得します。
xmsVOID send(const Message & message, const xmsINT deliveryMode, const xmsINT priority, const xmsLONG timeToLive) const;
メッセージ・プロデューサーが作成されたときに指定された宛先に、メッセージを送信します。指定された送達モード、優先順位、および存続時間を使用してメッセージを送信します。
ブローカーへのリアルタイム接続の場合、値は XMSC_DELIVERY_NON_PERSISTENT である必要があります。
xmsVOID send(const Destination & destination, const Message & message) const;
メッセージ・プロデューサーの作成時に宛先が指定されなかったメッセージ・プロデューサーを使用する場合に、指定した宛先にメッセージを送信します。メッセージ・プロデューサーのデフォルト送達モード、優先順位、および存続時間を使用してメッセージを送信します。
通常、メッセージ・プロデューサーの作成時には宛先を指定しますが、宛先を指定しない場合、メッセージの送信ごとに宛先を指定する必要があります。
xmsVOID send(const Destination & destination, const Message & message, const xmsINT deliveryMode, const xmsINT priority, const xmsLONG timeToLive) const;
メッセージ・プロデューサーの作成時に宛先が指定されなかったメッセージ・プロデューサーを使用する場合に、指定した宛先にメッセージを送信します。指定された送達モード、優先順位、および存続時間を使用してメッセージを送信します。
通常、メッセージ・プロデューサーの作成時には宛先を指定しますが、宛先を指定しない場合、メッセージの送信ごとに宛先を指定する必要があります。
ブローカーへのリアルタイム接続の場合、値は XMSC_DELIVERY_NON_PERSISTENT である必要があります。
xmsVOID setDeliveryMode(const xmsINT deliveryMode);
メッセージ・プロデューサーによって送信されるメッセージのデフォルト送達モードを設定します。
ブローカーへのリアルタイム接続の場合、値は XMSC_DELIVERY_NON_PERSISTENT である必要があります。
デフォルト値は XMSC_DELIVERY_PERSISTENT です。ただし、デフォルト値が XMSC_DELIVERY_NON_PERSISTENT となるブローカーへのリアルタイム接続の場合を除きます。
xmsVOID setDisableMsgID(const xmsBOOL msgIDDisabled);
受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにメッセージ ID が含まれることを要求するかどうかを示します。
キュー・マネージャーへの接続またはブローカーへのリアルタイム接続では、このフラグは無視されます。サービス統合バスへの接続では、フラグが尊重されます。
xmsVOID setDisableMsgTS(const xmsBOOL timeStampDisabled);
受信側アプリケーションが、メッセージ・プロデューサーにより送信されるメッセージにタイム・スタンプが含まれることを要求するかどうかを示します。
ブローカーへのリアルタイム接続では、このフラグは無視されます。 キュー・マネージャーへの接続またはサービス統合バスへの接続では、フラグは尊重されます。