IDirectPlayLobby2::SetLobbyMessageEvent

Registers an event that will be set when a lobby message is received. The application must call this method if it needs to synchronize with messages. The lobby client can call this method to change the events specified in the call to the IDirectPlayLobby2::RunApplication method.

HRESULT SetLobbyMessageEvent(
DWORD dwFlags,
DWORD dwAppID,
HANDLE hReceiveEvent
);

Parameters

dwFlags

Reserved; must be zero.

dwAppID

Identifies which application the event is associated with when called from a lobby client (that communicates with several applications). When called from an application (that communicates with only one lobby client), this parameter must be zero. This ID number is obtained from IDirectPlayLobby2::RunApplication.

hReceiveEvent

Event handle to be set when a message is received.

Return Values

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

DPERR_GENERIC

DPERR_INVALIDINTERFACE

DPERR_INVALIDOBJECT

DPERR_INVALIDPARAMS

DPERR_OUTOFMEMORY

See Also

IDirectPlayLobby2::ReceiveLobbyMessage, IDirectPlayLobby2::SendLobbyMessage