IDirectPlayLobby3::SetLobbyMessageEvent

IDirectPlayLobby3 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 IDirectPlayLobby3::RunApplication method.

Syntax

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 IDirectPlayLobby3::RunApplication.
hReceiveEvent
Event handle to be set when a message is received.

Return Value

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

IDirectPlayLobby3::ReceiveLobbyMessage, IDirectPlayLobby3::SendLobbyMessage

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