Platform SDK: DirectX |
IDirectPlay4::AddPlayerToGroup メソッドは、プレーヤーを既存のグループに追加する。プレーヤーは、複数のグループのメンバになることができる。この API を使用して、グループを別のグループに追加することはできない (IDirectPlay4::AddGroupToGroup を参照)。アプリケーションでは、任意のプレーヤーを任意のグループに追加できる (ローカルに作成されていないプレーヤーおよびグループを含む)。
HRESULT AddPlayerToGroup( DPID idGroup, DPID idPlayer );
成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。
DPERR_CANTADDPLAYER |
DPERR_CONNECTIONLOST |
DPERR_INVALIDGROUP |
DPERR_INVALIDPLAYER |
DPERR_NOSESSIONS |
idPlayer がプレーヤー ID でない場合、または ID がローカル プレーヤーのものでない場合は、DPERR_INVALIDPLAYER を返す。
DPMSG_ADDPLAYERTOGROUP システム メッセージが作成され、その他のすべてのプレーヤーに送信される。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
IDirectPlay4::CreateGroup、IDirectPlay4::DeletePlayerFromGroup、DPMSG_ADDPLAYERTOGROUP