IDirectPlay8Peer::DestroyPeer 메서드

세션으로부터 피어를 삭제한다.

구문

HRESULT DestroyPeer(      

    const DPNID dpnidClient,
    void *const pDestroyInfo,
    const DWORD dwDestroyInfoSize,
    const DWORD dwFlags
);

파라미터

dpnidClient

[in] 삭제하는 피어의 식별자를 지정하는 DPNID 형의 변수.

pDestroyInfo

[in] 상세한 삭제 데이터 정보를 기술하는 값의 포인터.

dwDestroyInfoSize

[in] pDestroyInfo 파라미터에 보관 유지되는 데이터의 사이즈를 지정하는 DWORD 형의 변수.

dwFlags

[in] 예약이 끝난 상태. 0 이 아니면 안된다.

반환값

성공했을 경우는 S_OK 를 돌려주어, 실패했을 경우는 다음의 몇개의 에러값을 돌려준다.

DPNERR_INVALIDPARAM	메서드에 건네진 1 개 이상의 파라미터가 무효이다.
DPNERR_INVALIDPLAYER	player ID 가, 이 게임 세션에 대한 유효한 player ID 로서 인식되지 않다.
DPNERR_NOTHOST	클라이언트가 호스트 이외의 컴퓨터에 접속하려고 했다. 또, 호스트 이외의 컴퓨터가 애플리케이션의 기술을 설정하려고 했을 경우에, 이 에러값을 돌려주는 일이 있다.

주의

player를 삭제할 수 있는 것은, 세션 호스트뿐이다. 삭제된 player는,DPN_MSGID_TERMINATE_SESSION 메시지에 의해 통지된다. 메시지에 관련지을 수 있는 구조체에는,pDestroyInfo 파라미터에 의해 건네받는 데이터가 저장 된다. 다른 세션 멤버가 이 메서드를 호출하면, 메서드는 실패해, DPNERR_NOTHOST 를 돌려준다.