Microsoft DirectX 8.0 (C++)

IDirectPlay8Server::CreateGroup

現在のセッションにグループを作成する。このメソッドが呼び出されると、サーバーのメッセージ ハンドラが DPN_MSGID_CREATE_GROUP メッセージを受け取る。

  マルチキャスティングはこのリリースではサポートされていない。

HRESULT CreateGroup(
const DPN_GROUP_INFO *const pdpnGroupInfo,
VOID *const pvGroupContext,
VOID *const pvAsyncContext,
DPNHANDLE *const phAsyncHandle,
const DWORD dwFlags
);

パラメータ

pdpnGroupInfo
グループの記述を保持する DPN_GROUP_INFO 構造体へのポインタ。
pvGroupContext
グループのコンテキスト値へのポインタ。この値は、ローカル アプリケーションのメッセージ ハンドラが DPN_MSGID_CREATE_GROUP メッセージを処理するときに事前に設定される。このパラメータはオプションであり、NULL に設定できる。
pvAsyncContext
ユーザー指定のコンテキストへのポインタ。これは、DPN_MSGID_ASYNC_OP_COMPLETE システム メッセージの pvUserContext メンバに返される。
phAsyncHandle
DPNHANDLE。値が返される。ただし、Microsoft® DirectPlay® 8.0 ではこの操作の取り消しは許可されていないため、値を使用することはできない。
dwFlags
このメソッドが処理される方法を制御するフラグ。このメソッドには、次のフラグを設定できる。
DPNCREATEGROUP_SYNC
メソッドを同期をとりながら処理する。

戻り値

メソッドが同期をとりながら処理され、処理が成功した場合は S_OK を返す。デフォルトでは、このメソッドは非同期に実行され、通常は DPNSUCCESS_PENDING か、または次のエラー値を返す。

DPNERR_INVALIDFLAGS

注意

Microsoft® DirectPlay® は、階層グループを保持しない。これは、これらのグループがフラット グループとグループ データの活用により簡単に実装できるためである。

動作環境

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