次の方法で共有

IDirectPlay8Peer::CreateGroup メソッド

  • [アーティクル]

IDirectPlay8Peer::CreateGroup メソッド

現在のセッションにグループを作成する。グループはプレーヤの論理的な集まりである。

構文

HRESULT CreateGroup(      
    const DPN_GROUP_INFO *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 メンバに返される。このパラメータはオプションであり、NULL に設定できる。
  • phAsyncHandle
    [out] DPNHANDLE。値が返される。ただし、Microsoft® DirectPlay® ではこの操作の取り消しは許可されていないため、値を使うことはできない。
  • dwFlags
    [in] このメソッドが処理される方法を制御するフラグ。このメソッドには、次のフラグを設定できる。
    • DPNCREATEGROUP_SYNC
      メソッドを同期をとりながら処理する。

戻り値

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

DPNERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。

注意

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

このメソッドが呼び出されると、すべてのピアが DPN_MSGID_CREATE_GROUP メッセージを受け取る。

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