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