IDirectPlayLobby2::SendLobbyMessage

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 zero. This ID is obtained by using the IDirectPlayLobby2::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:

DPERR_APPNOTSTARTED

DPERR_BUFFERTOOLARGE

DPERR_GENERIC

DPERR_INVALIDINTERFACE

DPERR_INVALIDOBJECT

DPERR_INVALIDPARAMS

DPERR_OUTOFMEMORY

DPERR_TIMEOUT

See Also

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