IDirectPlay4::SetGroupConnectionSettings

---

IDirectPlay4 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.

Syntax

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 Value

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

DPERR_ACCESSDENIED

DPERR_CONNECTIONLOST

DPERR_INVALIDGROUP

DPERR_INVALIDPARAMS

DPERR_UNSUPPORTED

Remarks

Call IDirectPlay4::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, IDirectPlayLobby3::RunApplication, IDirectPlay4::GetGroupConnectionSettings

---

 Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.