Microsoft DirectX 8.0 (Visual Basic)

DirectPlay8Peer.SetPeerInfo

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

SetPeerInfo(PlayerInfo As DPN_PLAYER_INFO) As Long

指定項目

PlayerInfo
設定するピア情報を保持する DPN_PLAYER_INFO 型。

戻り値

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

エラー コード

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

DPNERR_NOCONNECTION
DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM

注意

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

アプリケーションへの接続後、このメソッドを使用してピア情報を変更できる。接続後このメソッドが呼び出されると、DirectPlay は各プレーヤーの DirectPlay8Event.InfoNotify メソッドを呼び出して、プレーヤーにデータが更新されたことを通知する。