Platform SDK: DirectX

EnumConnectionsCallback

EnumConnectionsCallback は、IDirectPlay4::EnumConnections メソッドに対するアプリケーション定義のコールバック関数である。

BOOL FAR PASCAL EnumConnectionsCallback(
  LPCGUID lpguidSP,
  LPVOID lpConnection,
  DWORD dwConnectionSize,
  LPCDPNAME lpName,
  DWORD dwFlags,
  LPVOID lpContext
);

パラメータ

lpguidSP
接続に関連付けられた DirectPlay サービス プロバイダまたはロビー プロバイダの GUID。この GUID を使用すると、列挙の順序や名前を使用しなくても、サービス プロバイダやロビー プロバイダを一意に識別できる。
lpConnection
接続が格納されているバッファへの読み取り専用ポインタ。このパラメータは、DirectPlay オブジェクトを初期化するために IDirectPlay4::InitializeConnection メソッドに渡される。このバッファには、DirectPlay アドレスが格納されている。
dwConnectionSize
lpConnection バッファのサイズ (バイト単位)。
lpName
DPNAME 構造体への読み取り専用ポインタ。この構造体には、ユーザーに表示する接続の短縮名が格納されている。

ANSI インターフェイスで IDirectPlay4::EnumConnections を呼び出す場合は、文字列を ANSI として参照すること。Unicode インターフェイスで EnumConnections を呼び出す場合は、文字列を Unicode として参照すること。

dwFlags
接続のタイプを示すフラグ。EnumConnections に渡される dwFlags と等価である。
lpContext
アプリケーションにより定義されたコンテキストへのポインタ。

戻り値

列挙を継続する場合は、TRUE を返す。列挙を停止する場合は、FALSE を返す。

注意

アプリケーションは、IDirectPlay4::EnumConnections メソッドを使用するために、この関数を実装する必要がある。この関数は、列挙された接続ごとに 1 回ずつ呼び出される。

アプリケーションは、ユーザーに表示したり、IDirectPlay4::InitializeConnectionメソッドで使用するために、メモリを割り当て、各接続をコピーする。

必要条件

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dplay.h で宣言。

参照

IDirectPlay4::EnumConnectionsIDirectPlay4::InitializeConnection