Platform SDK: DirectX

DirectPlay4.SendChatMessage

DirectPlay4.SendChatMessage メソッドは、ほかのプレーヤー、プレーヤーのグループ、またはすべてのプレーヤーにテキスト メッセージを送信する。チャット メッセージを受信しているプレーヤーは、プレーヤーの受信キュー内の DPSYS_CHAT システム メッセージで通知される。このメソッドは、ロビー セッションで使用する必要がある。

object.SendChatMessage(fromPlayerId As Long, _
    toPlayerId As Long, _
    flags As CONST_DPSENDFLAGS, _
    message As String) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
fromPlayerId
送信側のプレーヤーの ID。このプレーヤー ID は、このコンピュータ上のローカル プレーヤーのいずれかに一致していなければならない。
toPlayerId
メッセージを送信するプレーヤーの ID、プレーヤーのグループの ID、またはセッション内のすべてのプレーヤーにメッセージを送信する場合は DPID_ALLPLAYERS。
flags
メッセージの送信方法を示す値。このパラメータに 0 を設定すると、メッセージは保証なしで送信される。
DPSEND_GUARANTEED
利用可能であれば、保証された配信方法を使用してメッセージを送信する。
message
送信するメッセージ。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。

DPERR_ACCESSDENIED
DPERR_CONNECTIONLOST
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER

toPlayerId の ID が有効なプレーヤーまたはグループでない場合は、DPERR_INVALIDPARAMS を返す。fromPlayerId の ID が有効なプレーヤーでない場合は、DPERR_INVALIDPLAYER を返す。fromPlayerId の ID がローカル プレーヤーでない場合は、DPERR_ACCESSDENIED を返す。

注意

このメソッドは、異なるクライアント アプリケーションが接続可能なロビー セッション内でのプレーヤー対プレーヤーのチャットを可能にする。アプリケーション セッションでは、DirectPlay4.Send メソッドを使用してチャット メッセージを送信することができる。

受信側のプレーヤーは、システム メッセージ (fromPlayerId = DPID_SYSMSG) を受け取る。