Platform SDK: DirectX |
IDirectPlay4::SetGroupName メソッドは、グループの作成後にその名前を設定する。グループの名前を設定できるのは、それを作成したコンピュータのみである。セッション記述で DPSESSION_NODATAMESSAGES が設定されている場合を除き、その他すべてのプレーヤーに、変更を知らせる DPMSG_SETPLAYERORGROUPNAME システム メッセージが送信される。
HRESULT SetGroupName( DPID idGroup, LPDPNAME lpGroupName, DWORD dwFlags );
成功した場合は DP_OK を返す。失敗した場合は、次のエラー値のいずれかを返す。
DPERR_CONNECTIONLOST |
DPERR_INVALIDGROUP |
DPERR_INVALIDOBJECT |
DPERR_INVALIDPARAMS |
DPERR_INVALIDPLAYER |
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。
DPNAME、DPMSG_SETPLAYERORGROUPNAME、IDirectPlay4::GetGroupName、IDirectPlay4::Send