Platform SDK: DirectX |
DirectPlay4.SendChatMessage メソッドは、ほかのプレーヤー、プレーヤーのグループ、またはすべてのプレーヤーにテキスト メッセージを送信する。チャット メッセージを受信しているプレーヤーは、プレーヤーの受信キュー内の DPSYS_CHAT システム メッセージで通知される。このメソッドは、ロビー セッションで使用する必要がある。
object.SendChatMessage(fromPlayerId As Long, _ toPlayerId As Long, _ flags As CONST_DPSENDFLAGS, _ message As String)
失敗すればエラーが発生し、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) を受け取る。