##

IDirectPlayLobby2::SetLobbyMessageEvent

IDirectPlayLobby2 Interface

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

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