Platform SDK: DirectX

DirectPlay4.SetPlayerName

DirectPlay4.SetPlayerName メソッドは、ローカル プレーヤーの正式名およびフレンドリ名を変更する。名前を変更できるのは、そのプレーヤーを作成したコンピュータだけである。

object.SetPlayerName(playerId As Long, _ 
  friendlyName As String, _ 
  formalName As String, _ 
  flags As CONST_DPSETFLAGS) 

パラメータ

object
DirectPlay4 オブジェクトを表すオブジェクト式。
playerId
データを送信するローカル プレーヤーの ID。
friendlyName
プレーヤーのフレンドリ ("ショート") 名。
formalName
プレーヤーの正式 ("ロング") 名。
flags
名前の伝承方法を示す、CONST_DPSETFLAGS 列挙型のフラグ。

エラー コード

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

DPERR_ACCESSDENIED
DPERR_CONNECTIONLOST
DPERR_INVALIDOBJECT
DPERR_INVALIDPLAYER

注意

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

参照

DirectPlay4.GetPlayerFriendlyNameDirectPlay4.GetPlayerFormalName