Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::GetConnectionSettings

指定された接続の接続設定セットを取得する。これらの設定は、IDirectPlay8LobbyClient::ConnectApplicationIDirectPlay8LobbyClient::SetConnectionSettings または IDirectPlay8LobbiedApplication::SetConnectionSettings メソッドを呼び出して設定できる。

接続設定を取得すると、ユーザーに返される各アドレス オブジェクトに参照が追加される。したがって、構造体の処理が終了したら、ユーザーは各アドレス オブジェクトに対して Release を呼び出す必要がある。

HRESULT GetConnectionSettings(
const DPNHANDLE hConnection,
DPL_CONNECTION_SETTINGS *const pdplConnectSettings,
DWORD*pdwDataSize,
const DWORD dwFlags
);

パラメータ

hConnection
設定を取得する接続のハンドル。
pdplConnectSettings
指定された接続の接続設定を受け取るバッファへのポインタ。
pdwDataSize
pdplConnectSettings 構造体に指定されたバッファのサイズ (バイト単位) を保持する DWORD へのポインタ。バッファが接続設定を保持できるだけの大きさではない場合、DPNERR_BUFFERTOOSMALL が返され、この値には必要なバッファ サイズが設定される。成功した場合、この値は、指定されたバッファに書き込まれたバイト数を保持する。
dwFlags
将来の使用に備えて予約されているので、0 に設定しておく。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDPARAM
DPNERR_BUFFERTOOSMALL
DPNERR_INVALIDOBJECT
DPNERR_INVALIDFLAGS

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplobby8.h で宣言。