Microsoft DirectX 8.0 (Visual Basic) |
Microsoft® DirectPlay® ゲームをホストするアプリケーションを列挙する。列挙基準を満たすアプリケーションが見つかると、アプリケーションのメッセージ ハンドラに DirectPlay8Event.EnumHostsResponse メソッドが呼び出される。このメソッドは、見つかったアプリケーションを記述する DPN_APPLICATION_DESC 型を格納する DPNMSG_ENUM_HOSTS_RESPONSE メッセージ型を含む。
EnumHosts(ApplicationDesc As DPN_APPLICATION_DESC, _ AddrHost As DirectPlay8Address, _ DeviceInfo As DirectPlay8Address, _ lRetryCount As Long, _ lRetryInterval As Long, _ lTimeOut As Long, _ lFlags As CONST_DPNOPERATIONS, _ UserData As Any, _ UserDataSize As Long) As Long
この処理に対する非同期ハンドルを返す。これは、要求が非同期で処理される場合に、要求を取り消すために DirectPlay8Client.CancelAsyncOperation メソッドの lAsyncHandle パラメータで使用されるハンドルである。
失敗した場合は、Err.Number に次のいずれかの値が設定される。
DPNERR_TIMEDOUT |
DPNERR_INVALIDFLAGS |
DPNERR_INVALIDPARAM |
列挙の処理にはさまざまな方法があるため、メディアに関して特に知識がない限り、アプリケーションでは lEnumPeriod を指定しないことを推奨する。