Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbyClient::Send

このロビー クライアントによって起動または接続されたロビー アプリケーションにメッセージを送信する。

このメソッドは、ターゲットのメッセージ ハンドラに DPL_MSGID_RECEIVE システム メッセージを送信する。

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

パラメータ

hConnection
メッセージ送信のターゲットを指定する DPNHANDLE 型の変数。次のフラグも指定できる。
DPLHANDLE_ALLAPPLICATIONS
指定したメッセージが、ロビー クライアント アプリケーションに接続されているすべてのロビー アプリケーションに送信される。
pBuffer
メッセージを保持するバイトの配列へのポインタ。
pBufferSize
pBuffer パラメータにメッセージ バッファのサイズ (バイト単位) を指定する DWORD 型の変数。このパラメータは 1 バイト以上、64 KB 以下でなければならない。
dwFlags
予約済み。0 に設定しておく。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDFLAGS
DPNERR_INVALIDHANDLE
DPNERR_INVALIDPARAM
DPNERR_SENDTOOLARGE

注意

バッファ サイズが 64 KB より大きい場合、メソッドは DPNERR_SENDTOOLARGE を返す。バッファ サイズが 0 に設定されている場合、メソッドは DPNERR_INVALIDPARAM を返す。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplobby8.h で宣言。