Platform SDK: DirectX |
IDirectPlay4::EnumGroups メソッドは、カレント セッションの最上位グループをすべて列挙する。最上位グループとは、IDirectPlay4::CreateGroup メソッドにより作成されたグループである。開いているセッションがない場合は、DPENUMGROUPS_session フラグとセッションの guidInstance を指定すると、リモート セッションのグループを列挙できる。パスワードで保護されたリモート セッションは列挙できない。
アプリケーションで実装するコールバック関数へのポインタは必ず指定する。DirectPlay は、セッション内で dwFlags で指定された条件に一致するグループごとにそのコールバック関数を呼び出す。
接続していないロビー セッションで EnumGroups を使用することはできない。
HRESULT EnumGroups( LPGUID lpguidInstance, LPDPENUMPLAYERSCALLBACK2 lpEnumPlayersCallback2, LPVOID lpContext, DWORD dwFlags );
次の値のいずれかまたはいくつかを指定できる。
処理が成功した場合は DP_OK を返す。失敗した場合は、次のエラー メッセージのいずれかを返す。
DPERR_CONNECTIONLOST |
DPERR_INVALIDPARAMS |
DPERR_NOSESSIONS |
DPERR_UNAVAILABLE |
コールバックが無効な場合、guidInstance が無効な場合、または無効なフラグが指定された場合は、DPERR_INVALIDPARAMS を返す。開いているセッションがない場合は、DPERR_NOSESSIONS を返す。リモート セッションを列挙できなかった場合は、DPERR_UNAVAILABLE を返す。
グループ内のサブグループを列挙するには、IDirectPlay4::EnumGroupsInGroup を使用すること。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
EnumPlayersCallback2、IDirectPlay4::CreateGroup、IDirectPlay4::DestroyGroup、IDirectPlay4::EnumSessions