##

IDirectPlay3::SetGroupConnectionSettings

IDirectPlay3 Interface

Sets the connection settings for a session that will be launched from this group. This method can only be used in a lobby session.

HRESULT SetGroupConnectionSettings(
DWORD dwFlags,
DPID idGroup,
LPDPLCONNECTION lpConnection
);

##### Parameters

dwFlags
  Not used. Must be zero.
idGroup
  The DPID of the group to set the connection settings on.
lpConnection
  Pointer to a DPLCONNECTION structure describing the application to be launched, the service provider to use, and the session description of the session to be created.

##### Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_ACCESSDENIED
DPERR_INVALIDGROUP
DPERR_INVALIDPARAMS
DPERR_UNSUPPORTED

##### Remarks

Call IDirectPlay3::GetGroupConnectionSettings before calling SetGroupConnectionSettings to see if any of the DPLCONNECTION structure members already have default values (non-NULL or non-zero). If so, you may get an error if you try to change these default values.

You do not have to set the lpAddress and dwAddressSize data members of the DPLCONNECTION structure with SetGroupConnectionSettings. In the DPSESSIONDESC2 structure within the DPLCONNECTION structure, you do not have to fill in the guidInstance member.

##### See Also

DPLCONNECTION, IDirectPlayLobby2::RunApplication, IDirectPlay3::GetGroupConnectionSettings

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.