Platform SDK: DirectX |
The IDirectPlay4::GetGroupConnectionSettings method retrieves the connection settings for a group from the DPLCONNECTION structure. Any sessions launched from this group will use these settings. This method can only be used in a lobby session.
HRESULT GetGroupConnectionSettings( DWORD dwFlags, DPID idGroup, LPVOID lpData, LPDWORD lpdwDataSize );
Returns DP_OK if successful, or one of the following error values otherwise:
DPERR_ACCESSDENIED |
DPERR_BUFFERTOOSMALL |
DPERR_INVALIDGROUP |
DPERR_INVALIDFLAGS |
DPERR_INVALIDPARAMS |
DPERR_UNSUPPORTED |
Group connection settings are only relevant for staging area groups.
You can see if a game has been launched by looking at the guidInstance data member of the DPSESSIONDESC2 structure, whose pointer is contained in the lpSessionDesc data member of the DPLCONNECTION structure returned by this method. The guidInstance will be GUID_NULL until a game has been launched.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dplay.h.
Import Library: Use dplayx.lib.
DPLCONNECTION, IDirectPlayLobby3::RunApplication, IDirectPlay4::SetGroupConnectionSettings