IDirectPlay8Client::GetCaps 메서드

현재의 인터페이스의 DPN_CAPS 또는 DPN_CAPS_EX 구조체를 얻어온다.

구문

HRESULT GetCaps(      

    DPN_CAPS *const pdpnCaps,
    const DWORD dwFlags
);

파라미터

pdpnCaps

[out] Caps 정보를 받는 DPN_CAPS 또는 DPN_CAPS_EX 구조체. 이 구조체의 dwSize 멤버에는 적절한 값을 설정할 필요가 있다.

dwFlags

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

반환값

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

DPNERR_INVALIDOBJECT	Microsoft® DirectPlay® 개체의 포인터는 무효이다.
DPNERR_INVALIDPARAM	메서드에 건네진 1 개 이상의 파라미터가 무효이다.
DPNERR_INVALIDPOINTER	파라미터로서 지정된 포인터가 무효이다.
DPNERR_UNINITIALIZED	요구된 개체가 초기화되지 않다.

주의

IDirectPlay8Client::Initialize 의 호출이 성공한 후에, 이 메서드를 호출할 필요가 있다.

DirectPlay 는,pdpnCaps 가 참조하는 구조체의 사이즈에 근거해 DPN_CAPS 또는 DPN_CAPS_EX 가 사용되고 있는지를 판단한다.