Platform SDK: DirectX

IDirectPlay4::AddPlayerToGroup

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

HRESULT AddPlayerToGroup(
  DPID idGroup,
  DPID idPlayer
);

パラメータ

idGroup
追加するグループのグループ ID。
idPlayer
グループに追加するプレーヤーのプレーヤー ID。

戻り値

成功した場合は 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::CreateGroupIDirectPlay4::DeletePlayerFromGroupDPMSG_ADDPLAYERTOGROUP