Microsoft DirectX 8.0 (Visual Basic)

DirectPlay8Client.SetClientInfo

アプリケーションとのクライアントの静的設定を設定する。アプリケーションに基本的なプレーヤー情報を転送するには、接続前にこのメソッドを呼び出す。クライアントが正しくアプリケーションに接続すると、サーバーはこのメソッドで取得された情報を DirectPlay8Server.GetClientInfo メソッドを呼び出して取得できる。

SetClientInfo(PlayerInfo As DPN_PLAYER_INFO, _
    [lFlags As CONST_DPNOPERATIONS]) As Long

指定項目

PlayerInfo
設定するピア情報を保持する DPN_PLAYER_INFO 型。
lFlags
このメソッドが同期をとりながら処理できるようにするには、CONST_DPNOPERATIONS 列挙の DPNSETCLIENTINFO_SYNC フラグを設定する。

戻り値

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

エラー コード

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

DPNERR_NOCONNECTION
DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM

注意

DirectPlay8Client.SetClientInfo メソッドを使用すると処理に負担がかかるため、非静的情報は DirectPlay8Client.Send メソッドを使用して転送すること。

アプリケーションへの接続後、このメソッドを使用してクライアント情報を変更できる。接続後にこのメソッドを呼び出すと、サーバーのメッセージ ハンドラで DirectPlay8Event.InfoNotify メソッドが呼び出される。