Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbiedApplication::Send

Sends a message from the lobbied application to the lobby client.

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

Parameters

hConnection
Variable of type DPNHANDLE that specifies the lobby client that the message is sent to. You may also specify the following flag.
DPLHANDLE_ALLAPPLICATIONS
The message you have specified will be sent to all lobby clients to which you are connected.
pBuffer
Pointer to a variable of type BYTE that contains the message buffer.
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.