Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::Send

Sends a message to a lobbied application that was launched by this lobby client or was connected by this lobby client.

This method sends a DPL_MSGID_RECEIVE system message to the target's message handler.

HRESULT Send(
const DPNHANDLE hConnection,
BYTE *const pBuffer,
const DWORD pBufferSize,
const DWORD dwFlags
);

Parameters

hConnection
Variable of type DPNHANDLE that specifies the target for the message transmission. You may also specify the following flag.
DPLHANDLE_ALLAPPLICATIONS
The message you have specified will be sent to all lobbied applications that are connected to your lobby client application.
pBuffer
Pointer to an array of bytes that contains the message.
pBufferSize
Variable of type DWORD that specifies the size of the message buffer in the pBuffer parameter, in bytes. This parameter must be at least 1 byte and no more than 64 KB.
dwFlags
Reserved. Must be 0.

Return Values

Returns S_OK if successful, or one of the following error values.

DPNERR_INVALIDFLAGS
DPNERR_INVALIDHANDLE
DPNERR_INVALIDPARAM
DPNERR_SENDTOOLARGE

Remarks

If the buffer size is larger than 64 KB, the method returns DPNERR_SENDTOOLARGE. If the buffer size is set to 0, the method returns DPNERR_INVALIDPARAM.

Requirements

  Windows NT/2000: Available as a redistributable for Windows 2000 and later.
  Windows 95/98: Available as a redistributable for Windows 95 and later.
  Header: Declared in Dplobby8.h.