DirectPlay DirectPlay C/C++ 레퍼런스 인터페이스 IDirectPlay8LobbiedApplication Send [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
로비 애플리케이션으로부터 로비 클라이언트에 메시지를 송신한다.
구문
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 를 돌려준다.