IDirectPlay8LobbyClient::Send メソッド

IDirectPlay8LobbyClient::Send メソッド

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

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

構文

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

パラメータ

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

戻り値

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

DPNERR_INVALIDFLAGS	このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDHANDLE	指定されたハンドルは無効である。
DPNERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_SENDTOOLARGE	バッファが大きすぎた。

注意

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