DPLMSG_SYSTEMMESSAGE

The DPLMSG_SYSTEMMESSAGE structure is a system message passed between the lobby and an application.

typedef struct {
    DWORD    dwType;
    GUID     guidInstance;
} DPLMSG_SYSTEMMESSAGE, FAR *LPDPLMSG_SYSTEMMESSAGE;

dwType

Identifies what type of system message has been received.

DPLSYS_APPTERMINATED

Indicates the application started by IDirectPlayLobby3::RunApplication has terminated.

DPLSYS_CONNECTIONSETTINGSREAD

Indicates the application started by the IDirectPlayLobby3::RunApplication method has read the connection settings.

DPLSYS_DPLAYCONNECTFAILED

Indicates the application started by IDirectPlayLobby3::RunApplication failed to connect to a session.

DPLSYS_DPLAYCONNECTSUCCEEDED

Indicates the application started by IDirectPlayLobby3::RunApplication has created a session and is ready for other applications to join or has successfully joined a session.

DPLSYS_NEWCONNECTIONSETTINGS

Indicates that a waiting application was found when a lobby client called RunApplication. The waiting application can now read the connection settings with GetConnectionSettings and join a session using ConnectEx.

guidInstance

GUID identifying the instance of the DirectPlay session that this message corresponds to.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplobby.h.