IDirectPlay8Client::Close 메서드

세션에의 접속을 닫아IDirectPlay8Client 개체를 미초기화한다. 이 메서드는,IDirectPlay8Client::Initialize 메서드의 호출에 의해 올바르게 초기화된 모든 개체로 호출할 필요가 있다.

구문

HRESULT Close(      

    const DWORD dwFlags
);

파라미터

dwFlags

[in] 다음의 플래그를 지정할 수 있다.

DPNCLOSE_IMMEDIATE

곧바로 닫는다. 미처리의 호출이 완료할 때까지 대기하지 않는다.

반환값

성공했을 경우는, S_OK 를 돌려준다. 그 이외의 경우는, 다음의 몇개의 에러값을 돌려준다.

DPNERR_UNINITIALIZED

요구된 개체가 초기화되지 않다.

주의

IDirectPlay8Client::Close 를 호출하면, 큐로 송신되는 것을 기다리는 보증 첨부 메시지를 포함해 미처리의 모든 처리가 삭제된다. 보증 첨부 메시지로서 이미 송신되고 있는 메시지는, 송신 확인을 받아들일 때까지 재시행된다. 모든 메시지의 송신을 확인하려면 ,IDirectPlay8Client::Close 를 호출하기 전에, 미처리의 IDirectPlay8Client::Send 호출이 모두 완료할 때까지 대기한다.

애플리케이션을 대기시키고 싶지 않은 경우는,IDirectPlay8Client::CancelAsyncOperation 를 호출해 미처리의 송신을 모두 취소한 후,IDirectPlay8Client::Close 를 호출하는지,IDirectPlay8Client 인터페이스로 마지막 릴리즈 호출을 실시한다. 이 요건을 채우지 않으면, 예기치 않은 결과가 생기는 일이 있다.

IDirectPlay8Client::Close 를 호출하면,IDirectPlay8Client 에 관련하는 DPN_CAPS ,DPN_CAPS_EX , 및 DPN_SP_CAPS 는 무효가 된다.