DPL_CONNECTION_SETTINGS Structure

Used to specify the settings you want to associate with a connection. These settings contain all the information required to create, initialize and connect/host a Microsoft® DirectPlay® object.

Syntax

typedef struct _DPL_CONNECTION_SETTINGS {
    DWORD dwSize;
    DWORD dwFlags;
    DPN_APPLICATION_DESC dpnAppDesc;
    IDirectPlay8Address *pdp8HostAddress;
    IDirectPlay8Address *ppdp8DeviceAddresses;
    DWORD cNumDeviceAddresses;
    PWSTR pwszPlayerName;
} DPL_CONNECTION_SETTINGS, *PDPL_CONNECTION_SETTINGS;

Members

dwSize

Size of the DPL_CONNECTION_SETTINGS structure. The application must set this to sizeof( DPL_CONNECTION_SETTINGS ) before using this structure.

dwFlags

The following flag can be specified.

DPLCONNECTSETTINGS_HOST

The application should host the session.

dpnAppDesc

Pointer to the application description that should be passed to the Connect or Host call when DirectPlay initialized.

pdp8HostAddress

If DPLCONNECTSETTINGS_HOST is not specified, this is the address of the session the client should connect to. If DPLCONNECTSETTINGS_HOST is specified, this member must be NULL.

ppdp8DeviceAddresses

This structure contains an array of pointers to device addresses. If DPLCONNECTSETTINGS_HOST is specified, this member will contain the addresses the host should listen on. If DPLCONNECTSETTINGS_HOST is not specified, this member will contain the address of the devices the client should use when connecting.

cNumDeviceAddresses

Number of addresses specified in the ppdp8DeviceAddresses member.

pwszPlayerName

Can be used to pass the player name you want the DirectPlay object to use when launching. This member can be NULL.

Structure Information

Header	dplobby8.h
Minimum operating systems	Windows 98, Pocket PC 2002