IDirectPlay8LobbiedApplication::Send メソッド
IDirectPlay8LobbiedApplication::Send メソッド
ロビー アプリケーションからロビー クライアントにメッセージを送信する。
構文
HRESULT Send(
const DPNHANDLE hConnection,
BYTE *const pBuffer,
const DWORD pBufferSize,
const DWORD dwFlags
);
パラメータ
- hConnection
[in] メッセージの送信先ロビー クライアントを指定する DPNHANDLE 型の変数。次のフラグも指定できる。DPLHANDLE_ALLCONNECTIONS
指定したメッセージが、接続しているすべてのロビー クライアントに送信される。
- pBuffer
[in] メッセージ バッファを保持する BYTE 型の変数へのポインタ。 - 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 を返す。