> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult

> XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult

# XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult

[XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync) 호출의 결과를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT XNetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult(
         XAsyncBlock* asyncBlock,
         uint16_t* preferredLocalUdpMultiplayerPort
)
```

### 매개 변수

*asyncBlock*   \_Inout\_\
형식: [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)\*

[XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync) 함수에 전달된 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) 구조체에 대한 포인터입니다.

*preferredLocalUdpMultiplayerPort*   \_Out\_\
형식: uint16\_t\*

호스트 엔디안 순서로 된 기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 포트 번호에 대한 포인터입니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## 설명

이 함수는 `XAsyncBlock` 구조체가 `NetworkingQueryPreferredLocalUdpMultiplayerPortAsyncResult` 함수에 전달되었을 때 비동기 멀티플레이어 트래픽을 위한 기본 설정 로컬 UDP 포트 번호를 가져옵니다. 검색되는 기본 설정 로컬 UDP 멀티플레이어 포트에 대한 자세한 내용은 [기본 설정 로컬 사용자 데이터그램 프로토콜(UDP) 멀티플레이어 포트 네트워킹 API](/build/console-features/networking/game-mesh/preferred-local-udp-multiplayer-port-networking)를 참조하세요. Microsoft Game Development Kit (GDK) 타이틀의 네트워크 정보에 대해서는 [네트워크 정보 검색](/build/console-features/networking/initialization-connectivity-networking)을 참조하세요.

반환된 기본 설정 로컬 UDP 멀티플레이어 포트는 원격 디바이스가 로컬 디바이스에 연결하기 위해 사용할 수 있는 공용 포트가 아니라, 이후 [소켓 bind](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-bind) 작업에서 활용되는 로컬 포트입니다. 이는 멀티플레이어 실시간 타이틀 네트워킹 흐름을 특별히 대상으로 하므로 TCP 또는 HTTP 트래픽이 아닌 UDP 트래픽에만 의미가 있습니다.

이 포트의 기본값은 UDP 3074이지만, 게이밍 트래픽에 적합하지 않다고 판단될 때의 자동 폴백과, 사용자가 XBOX 네트워크 설정 문제 해결사를 통해 설정할 수 있는 수동 재정의가 모두 존재합니다. 이 포트의 네트워크 동작은 사용자에게 표시되는 NAT 유형인 엄격(strict), 보통(moderate), 개방(open)을 결정하는 데 사용됩니다. 이 포트는 XBOX 파티 채팅, XBOX 네트워크 문제 해결사, 온라인 XBOX Live 문제 해결 설명서, CSS 문제 해결 흐름에서 사용되며, 사용자가 홈 라우터에서 수동으로 구성하는 경우가 많습니다.

반환된 포트는 인바운드 및 아웃바운드 패킷을 허용하도록 UPnP를 통해 사용자의 홈 라우터에 이미 구성되어 있습니다.

이 포트는 다른 모든 포트와 동일하게 취급되어야 하며 [Windows Sockets (Winsock)](https://learn.microsoft.com/windows/desktop/WinSock/windows-sockets-start-page-2) API와 함께 사용되어야 합니다. 타이틀은 이 포트에서 IPv4와 IPv6 모두에 바인딩하거나 이중 스택 소켓을 사용해야 하며, `INADDR_ANY`/`in6addr_any` 주소에 바인딩해야 합니다.

<Note>포트는 이 함수에서 호스트 엔디안 순서로 반환됩니다. `sockaddr_in::sin_port`와 `sockaddr_in6::sin6_port` 필드는 모두 네트워크 엔디안 순서입니다. 반환된 포트를 bind 함수에 전달할 때 엔디안을 변환하려면 [htons](https://learn.microsoft.com/windows/desktop/api/winsock/nf-winsock-htons) 함수를 사용해야 합니다.</Note>

반환된 포트로 원하는 서버 또는 피어와의 성공적인 소켓 연결을 확립할 수 있다고 보장되지는 않습니다. 일반적인 타이틀 재시도 및 폴백 로직을 수행해야 합니다.

타이틀은 필요한 경우 보안 계층과 필요한 네트워크 주소 변환(NAT) 감지 및 순회 구현을 제공해야 합니다.

성공적인 연결 가능성을 최대화하기 위해, 타이틀은 주요 게임 트래픽 소켓 흐름에 이 포트를 사용하는 것이 강력히 권장됩니다. 이 포트는 [Microsoft Azure PlayFab Party](/build/console-features/networking/game-mesh/playfab-party-intro-networking) 라이브러리에서 자동으로 사용됩니다. PlayFab Party 라이브러리를 명시적으로 다른 포트를 사용하도록 구성하지 않는 한, 기본 설정 로컬 UDP 멀티플레이어 포트에 직접 바인딩해서는 안 됩니다.

이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

## 요구 사항

**헤더:** XNetworking.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworking](/ko/reference/networking/xnetworking/xnetworking_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPortAsync](/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerportasync.md)
- [XNetworkingQueryPreferredLocalUdpMultiplayerPort](/ko/reference/networking/xnetworking/functions/xnetworkingquerypreferredlocaludpmultiplayerport.md)
- [XNetworkingUnregisterPreferredLocalUdpMultiplayerPortChanged](/ko/reference/networking/xnetworking/functions/xnetworkingunregisterpreferredlocaludpmultiplayerportchanged.md)