Microsoft DirectX 8.0 (Visual Basic) |
アプリケーションとのクライアントの静的設定を設定する。アプリケーションに基本的なプレーヤー情報を転送するには、接続前にこのメソッドを呼び出す。クライアントが正しくアプリケーションに接続すると、ほかのプレーヤーはこのメソッドで取得された情報を DirectPlay8Client.GetServerInfo メソッドを呼び出して取得できる。
SetServerInfo(PlayerInfo As DPN_PLAYER_INFO) As Long
この処理に対する非同期ハンドルを返す。これは、要求が非同期で処理される場合に、要求を取り消すために DirectPlay8Server.CancelAsyncOperation メソッドの lAsyncHandle パラメータで使用されるハンドルである。
失敗した場合は、Err.Number に次のいずれかの値が設定される。
DPNERR_NOCONNECTION |
DPNERR_INVALIDFLAGS |
DPNERR_INVALIDPARAM |
DirectPlay8Server.SetClientInfo メソッドを使用すると処理に負担がかかるため、非静的情報は DirectPlay8Server.SendTo メソッドを使用して転送すること。
アプリケーションへの接続後、このメソッドを使用してクライアント情報を変更できる。接続後このメソッドが呼び出されると、DirectPlay は各プレーヤーの DirectPlay8Event.InfoNotify メソッドを呼び出して、プレーヤーにデータが更新されたことを通知する。