IDirectPlayLobby3::SendLobbyMessage

The IDirectPlayLobby3::SendLobbyMessage method sends a message between the application and the lobby client.

HRESULT SendLobbyMessage(
  DWORD dwFlags,
  DWORD dwAppID,
  LPVOID lpData,
  DWORD dwDataSize
);

Parameters

dwFlags

Flags indicating the type of message being sent. The default (dwFlags = 0) is a custom message defined by the application sending it. Other possible values are:

DPLMSG_STANDARD

This is a standard message defined by DirectPlay.

dwAppID

Identifies which application to send a message to 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 0. This ID is obtained by using the IDirectPlayLobby3::RunApplication method.

lpData

Pointer to the buffer containing the message to send.

dwDataSize

Size, in bytes, of the buffer.

Return Values

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

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.
  Import Library: Use dplayx.lib.

See Also

IDirectPlayLobby3::RunApplication, IDirectPlayLobby3::ReceiveLobbyMessage, DPLMSG_SETPROPERTY, DPLMSG_SETPROPERTYRESPONSE, DPLMSG_GETPROPERTY, DPLMSG_GETPROPERTYRESPONSE,