Microsoft DirectX 8.0 (Visual Basic)

DirectPlay8Peer.AddPlayerToGroup

グループにピアを追加する。

このメソッドが呼び出されると、DirectPlay は各プレーヤーの DirectPlay8Event.AddRemovePlayerGroup メソッドを呼び出して、プレーヤーに新しいグループ メンバを通知する。

AddPlayerToGroup(idGroup As Long, _
    idClient As Long, 
    lFlags As Long) As Long

指定項目

idGroup
ピアを追加する先のグループの識別子を指定する長整数型 (Long) の値。
idClient
グループに追加されるピアの識別子を指定する長整数型 (Long) の値。
lFlags
このメソッドが処理される方法を制御するフラグ。このメソッドには、次のフラグを設定できる。
DPNOP_SYNC
メソッドを同期をとりながら処理する。

戻り値

この処理に対する非同期ハンドルを返す。これは、要求が非同期で処理される場合に、要求を取り消すために DirectPlay8Peer.CancelAsyncOperation メソッドの lAsyncHandle パラメータで使用されるハンドルである。

エラー コード

失敗した場合は、Err.Number に次のいずれかの値が設定される。

DPNERR_INVALIDGROUP
DPNERR_INVALIDFLAGS

注意

ピアはそれ自体またはほかのピアを既存のグループに追加できる。ピアがグループに正しく追加されると、グループに送信されるすべてのメッセージがそのピアにも送信される。

ピアがそれ自体をグループに追加する場合は、idClient パラメータに DPNID_ME を渡す。