Platform SDK: DirectX

DirectPlay4.AddPlayerToGroup

DirectPlay4.AddPlayerToGroup メソッドは、プレーヤーを既存のグループに追加する。プレーヤーは、複数のグループのメンバになることができる。アプリケーションは、任意のプレーヤーを任意のグループに追加することができる (ローカルに作成されていないプレーヤーおよびグループを含む)。このメソッドを使用して、グループをほかのグループに追加することはできない (「DirectPlay4.AddGroupToGroup」を参照)。

object.AddPlayerToGroup(GroupId As Long, _
    playerId As Long) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
GroupId
追加先のグループの ID。
playerId
グループに追加するプレーヤーの ID。

エラー コード

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

DPERR_CANTADDPLAYER
DPERR_CONNECTIONLOST
DPERR_INVALIDGROUP
DPERR_INVALIDPLAYER
DPERR_NOSESSIONS

プレーヤーの DirectPlay ID がプレーヤー ID でない場合、またはその ID がローカル プレーヤーのものでない場合は、DPERR_INVALIDPLAYER を返す。

注意

DPSYS_ADDPLAYERTOGROUP システム メッセージが生成され、ほかのすべてのプレーヤーに送信される。

参照

DirectPlay4.CreateGroupDirectPlay4.DeletePlayerFromGroup