Поделиться через

XboxLiveEndpointPair Класс

  • Ссылка

Определение

Пространство имен:
Windows.Networking.XboxLive
Изменить

XboxLiveEndpointPair — это отношение безопасности и качества сети, установленное между двумя устройствами для обмена данными на основе сокетов.

API Windows.Networking.XboxLive обеспечивает одноранговое подключение (P2P) в различных средах, используя IPv4, IPv6 и технологии и службы преобразования сетевых адресов (NAT) Майкрософт (например, Teredo), чтобы определить и настроить наилучший доступный сетевой путь между конечными точками. Он также устанавливает шифрование трафика и защиту от незаконного изменения в качестве меры для снижения количества обмана. Кроме того, он проверяет подлинность пользователей и приложений через экосистему Xbox Live&dmash; интеграция сведений о подключении с другими службами Xbox Live. Затем эти сведения можно использовать при подборе матчей, чтобы попытаться сопоставить игроков с аналогичной статистикой подключения друг с другом.

API Windows.Networking.XboxLive дополняет и расширяет традиционные сетевые транспорты, такие как TCP и UDP, а также доступные API сокетов, WinSock и Windows.Networking.Sockets. Вы создаете XboxLiveEndpointPair с помощью этого API, а затем используете предпочтительный API транспорта для фактической передачи данных. Сама концепция XboxLiveEndpointPair связана с Windows.Networking.EndpointPair в том, что ее можно интерпретировать как набор локальных и удаленных IP-адресов и портов; но в XboxLiveEndpointPair эти свойства доступны только для чтения (так как система согласовывает их) и имеют связанное время действия (так как XboxLiveEndpointPair представляет собой активное отношение безопасности, которое может быть прекращено по различным причинам).

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

public ref class XboxLiveEndpointPair sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XboxLiveEndpointPair final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Networking.XboxLive.XboxLiveSecureSocketsContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class XboxLiveEndpointPair
Public NotInheritable Class XboxLiveEndpointPair
Наследование
Object Platform::Object IInspectable XboxLiveEndpointPair
Атрибуты
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств
Xbox One System Apps Extensions for the UWP (появилось в 10.0.0.1)
 Xbox Live Extension SDK (появилось в 10.0.10240.0)
 Xbox One Extensions for the UWP (появилось в 10.0.10240.0)
 Windows Desktop Extension SDK (появилось в 10.0.16299.0)
API contract
Windows.Networking.XboxLive.XboxLiveSecureSocketsContract (появилось в v1.0)

Комментарии

Экземпляры этого класса не создаются с помощью конструктора. Вместо этого вы используете один из методов CreateEndpointPairAsync или CreateEndpointPairForPorts в классе XboxLiveEndpointPairTemplate , чтобы создать пару конечных точек, которая следует определенному шаблону связи.

Свойства

LocalHostName

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
LocalPort

Возвращает порт для локальной конечной точки.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemoteDeviceAddress

Возвращает xboxLiveDeviceAddress для удаленной конечной точки.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemoteHostName

Возвращает имя узла для удаленной конечной точки.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
RemotePort

Возвращает порт для удаленной конечной точки.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
State

Возвращает значение, представляющее состояние этого xboxLiveEndpointPair.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
Template

Возвращает xboxLiveEndpointPairTemplate, используемый для создания экземпляра этой пары конечных точек.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

Методы

DeleteAsync()

Начинает корректное завершение связи безопасности XboxLiveEndpointPair между двумя конечными точками. Предпринята попытка уведомить удаленное устройство, хотя нет никакой гарантии, что это уведомление будет получено, если удаленное устройство больше не доступно или недоступно. Вместо этого удаленное устройство может истестечить время ожидания XboxLiveEndpointPair. Действие будет выполнено успешно независимо от удаленного устройства или предыдущего состояния XboxLiveEndpointPair.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
FindEndpointPairByHostNamesAndPorts(HostName, String, HostName, String)

Находит существующий экземпляр XboxLiveEndpointPair , если он существует, связанный с трафиком от первого узла и порта к второму узлу и порту.

Используйте этот метод для обратной работы от входящего трафика к xboxLiveEndpointPair , связанному с этим трафиком.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
FindEndpointPairBySocketAddressBytes(Byte[], Byte[])

Находит существующий экземпляр XboxLiveEndpointPair , если он существует, связанный с трафиком между двумя заданными адресами сокетов, где адреса сокетов предоставляются в виде массивов Byte, содержащих SOCKADDR_STORAGE Winsock или связанные структуры.

Используйте этот метод для обратной работы от входящего трафика к XboxLiveEndpointPair , связанному с этим трафиком.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
GetLocalSocketAddressBytes(Byte[])

Возвращает сведения об адресе сокета локальной конечной точки в виде массива byte. Этот метод заполняет указанный буфер байтов SOCKADDR_STORAGE адресом локального устройства для использования в последующих операциях Winsock с использованием API многопользовательской сети Xbox Live.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.
GetRemoteSocketAddressBytes(Byte[])

Получает сведения об адресе сокета удаленной конечной точки в виде массива byte. Этот метод заполняет указанный буфер байтов SOCKADDR_STORAGE адресом удаленного устройства для использования в последующих операциях Winsock с использованием API многопользовательской сети Xbox Live.

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

События

StateChanged

Событие, возникающее при изменении состояния XboxLiveEndpointPair .

Важно!

Этот API доступен не для всех приложений. Если ваша учетная запись разработчика не специально подготовлена корпорацией Майкрософт, вызовы этих API во время выполнения завершатся ошибкой.

Применяется к