IDirectPlay8Server::GetSPCaps 메서드

지정된 서비스 프로바이더의 DPN_SP_CAPS 구조체를 얻어온다.

구문

HRESULT GetSPCaps(      

    const GUID *const pguidSP,
    DPN_SP_CAPS *const pdpnSPCaps,
    const DWORD dwFlags
);

파라미터

pguidSP

[in] 정보를 취득하고 싶은 서비스 프로바이더를 지정하는 글로벌 일의 식별자 (GUID)의 포인터.

pdpnSPCaps

[out] 지정한 서비스 프로바이더에 관한 정보를 받는 DPN_SP_CAPS 구조체의 포인터. 이 구조체의 pdpnSPCaps. dwSize 멤버에는 적절한 값을 설정할 필요가 있다.

dwFlags

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

반환값

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

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

주의

이 메서드는, 지정한 서비스 프로바이더에 관한 정보를 얻어온다. IDirectPlay8Server::Initialize 의 호출이 성공한 후에, 이 메서드를 호출할 필요가 있다.