IDirectPlay8Server::CreateGroup メソッド
IDirectPlay8Server::CreateGroup メソッド
現在のセッションにグループを作成する。このメソッドが呼び出されると、サーバーのメッセージ ハンドラが DPN_MSGID_CREATE_GROUP メッセージを受け取る。
構文
HRESULT CreateGroup(
const DPN_GROUP_INFO const *const pdpnGroupInfo,
VOID *const pvGroupContext,
VOID *const pvAsyncContext,
DPNHANDLE *const phAsyncHandle,
const DWORD dwFlags
);
パラメータ
- pdpnGroupInfo
[in] グループの記述を保持する DPN_GROUP_INFO 構造体へのポインタ。 - pvGroupContext
[in] グループのコンテキスト値へのポインタ。この値は、ローカル アプリケーションのメッセージ ハンドラが DPN_MSGID_CREATE_GROUP メッセージを処理するときに事前に設定される。このパラメータはオプションであり、NULL に設定できる。 - pvAsyncContext
[in] ユーザー指定のコンテキストへのポインタ。これは、DPN_MSGID_ASYNC_OP_COMPLETE システム メッセージの pvUserContext メンバに返される。 - phAsyncHandle
[out] DPNHANDLE。値が返される。ただし、Microsoft® DirectPlay® ではこの操作の取り消しは許可されていないため、値を使うことはできない。 - dwFlags
[in] このメソッドが処理される方法を制御するフラグ。このメソッドには、次のフラグを設定できる。DPNCREATEGROUP_SYNC
メソッドを同期をとりながら処理する。
戻り値
メソッドが同期をとりながら処理され、処理が成功した場合は S_OK を返す。デフォルトでは、このメソッドは非同期に実行され、通常は DPNSUCCESS_PENDING か、または次のエラー値を返す。
DPNERR_INVALIDFLAGS | このメソッドに渡されたフラグは無効である。 |
注意
DirectPlay は、階層グループを保持しない。これは、フラット グループとグループ データの活用により階層グループは簡単に実装できるためである。
注 マルチキャスティングはこのリリースではサポートされていない。