PartyNetwork::GetDeviceConnectionType

메시지 또는 채팅 데이터를 이 네트워크의 지정된 대상 장치로 전송하기 위해 로컬 장치에서 사용하는 연결 유형을 검색합니다.

구문

PartyError GetDeviceConnectionType(  
    const PartyDevice* targetDevice,  
    PartyDeviceConnectionType* deviceConnectionType  
)

targetDevicePartyDevice*

연결 유형을 검색해야 하는 장치입니다.

deviceConnectionTypePartyDeviceConnectionType*
출력

출력 장치 연결 유형입니다.

PartyError

c_partyErrorSuccess 연결 유형 검색에 성공했거나, 그렇지 않으면 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

연결 유형은 장치가 초기 사용자를 네트워크에 처음 인증할 때 결정됩니다. 이 네트워크에서 PartyNetworkConfiguration::d irectPeerConnectivityOptions 필드를 통해 직접 피어 투 피어 연결을 허용한 경우 두 장치 모두 PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 옵션을 통해 이러한 연결을 제외하지 않았고, 해당 시점에 직접 피어 연결이 성공적으로 설정되었으므로 이 함수는 PartyDeviceConnectionType::D irectPeerConnection의 값을 보고합니다. 그렇지 않으면 PartyDeviceConnectionType::RelayServer를 보고합니다. 대상 PartyDevice 개체가 이 네트워크에 남아 있는 한 초기 인증 사용자에 대해 PartyNetwork::RemoveLocalUser()가 호출된 경우에도 해당 값은 변경되지 않습니다.

대상 장치가 로컬 장치인 경우 PartyDeviceConnectionType::D irectPeerConnection는 PartyNetworkConfiguration 설정 또는 PartyOption::LocalDeviceDirectPeerConnectivityOptionsMask 옵션에 관계없이 항상 보고됩니다.

대상 장치 개체가 이 네트워크에 참여하지 않는 경우 오류가 반환됩니다.

로컬 장치가 대상 장치 개체를 사용하여 추가 네트워크에 참여하는 경우 다른 네트워크 개체에서 이 동일한 기능을 호출하면 동일한 값을 보고한다고 가정하지 않도록 합니다.

헤더: Party.h