IDirectPlay8Server::SetGroupInfo メソッド
IDirectPlay8Server::SetGroupInfo メソッド
グループ名など、グループに関連付けられているデータ ブロックを設定する。
構文
HRESULT SetGroupInfo(
const DPNID dpnid,
DPN_GROUP_INFO *const pdpnGroupInfo,
PVOID const pvAsyncContext,
DPNHANDLE *const phAsyncHandle,
const DWORD dwFlags
);
パラメータ
- dpnid
[in] データ ブロックを変更するグループの識別子を指定する DPNID 型の変数。 - pdpnGroupInfo
[in] 設定するグループ データを記述する DPN_GROUP_INFO 構造体へのポインタ。この構造体の pwszName メンバまたは pvData メンバの値を変更するには、dwInfoFlags メンバに対応する DPNINFO_NAME フラグまたは DPNINFO_DATA フラグを設定する必要がある。 - pvAsyncContext
[in] ユーザー指定のコンテキストへのポインタ。これは、DPN_MSGID_ASYNC_OP_COMPLETE システム メッセージの pvUserContext メンバに返される。 - phAsyncHandle
[out] DPNHANDLE。値が返される。ただし、Microsoft® DirectPlay® ではこの操作の取り消しは許可されていないため、値を使うことはできない。 - dwFlags
[in] このメソッドが処理される方法を制御するフラグ。このメソッドには、次のフラグを設定できる。DPNSETGROUPINFO_SYNC
メソッドを同期をとりながら処理する。
戻り値
メソッドが同期をとりながら処理され、処理が成功した場合は S_OK を返す。デフォルトでは、このメソッドは非同期に実行され、通常は DPNSUCCESS_PENDING か、または次のいずれかのエラー値を返す。
DPNERR_INVALIDFLAGS | このメソッドに渡されたフラグは無効である。 |
DPNERR_INVALIDGROUP | グループ ID が、このゲーム セッションに対する有効なグループ ID として認識されていない。 |