Platform SDK: DirectX

DirectPlay4.SetGroupName

DirectPlay4.SetGroupName メソッドは、グループが作成された後に、その名前を設定する。グループの名前を設定できるのは、そのグループを作成したコンピュータだけである。

object.SetGroupName(GroupId As Long, _
    friendlyName As String, _
    formalName As String, _
    flags As CONST_DPSETFLAGS) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
GroupId
名前を設定するグループの ID。
friendlyName
グループのショート ネーム。グループがフレンドリ名を持たない場合は、"" を設定する。
formalName
グループのロング ネーム。グループが正式名を持たない場合は、"" を設定する。
flags
データ伝承のオプションを設定する、CONST_DPSETFLAGS 列挙型のフラグ。このパラメータに 0 を設定すると、名前は保証なしのメッセージングを使用して、すべてのリモート システムに伝承される。

エラー コード

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

DPERR_CONNECTIONLOST
DPERR_INVALIDGROUP
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER

注意

セッション記述で DPSESSION_NODATAMESSAGES が設定されている場合を除き、変更を通知するために、ほかのすべてのプレーヤーに DPSYS_SETPLAYERORGROUPNAME システム メッセージが送信される。

参照

DirectPlay4.GetGroupLongNameDirectPlay4.GetGroupShortNameDirectPlay4.Send