Platform SDK: DirectX |
DirectPlay4.AddPlayerToGroup メソッドは、プレーヤーを既存のグループに追加する。プレーヤーは、複数のグループのメンバになることができる。アプリケーションは、任意のプレーヤーを任意のグループに追加することができる (ローカルに作成されていないプレーヤーおよびグループを含む)。このメソッドを使用して、グループをほかのグループに追加することはできない (「DirectPlay4.AddGroupToGroup」を参照)。
object.AddPlayerToGroup(GroupId As Long, _ playerId As Long)
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CANTADDPLAYER |
DPERR_CONNECTIONLOST |
DPERR_INVALIDGROUP |
DPERR_INVALIDPLAYER |
DPERR_NOSESSIONS |
プレーヤーの DirectPlay ID がプレーヤー ID でない場合、またはその ID がローカル プレーヤーのものでない場合は、DPERR_INVALIDPLAYER を返す。
DPSYS_ADDPLAYERTOGROUP システム メッセージが生成され、ほかのすべてのプレーヤーに送信される。